远程开发遇到 Copilot 报错怎么办？
在 SSH 或 WSL 远程连接下，GitHub Copilot 偶尔会出现连接失败或无响应。别急着重装，大多数情况是网络、认证或环境配置的小问题。下面整理了一些实战中验证过的排查路径。
1. 先确认网络连通性
这是最常见的原因。打开远程终端，直接测试 API 可达性：
curl -v https://api.githubcopilot.com
如果返回 403 Forbidden，说明网络链路基本通畅；若超时或无法解析，请检查防火墙规则或代理设置。如果是公司内网，记得在 .bashrc 或 .zshrc 里配置好 HTTP_PROXY 环境变量，重启终端生效后再试。
2. 令牌刷新与重新登录
有时候本地会话过期会导致静默失败。操作很简单：
- 按下
Ctrl+Shift+P打开命令面板。 - 输入并执行
GitHub Copilot: Sign Out。 - 再次运行
GitHub Copilot: Sign In，按提示完成浏览器授权。
顺便去 GitHub Token 设置页 看一眼，确保没有手动撤销过相关权限。
3. 排除扩展冲突
有些 AI 辅助工具（比如 Tabnine）或格式化工具可能会抢占资源。试着临时禁用它们，或者用纯净模式启动 VS Code 测试：
code --disable-extensions
单独启用 Copilot 看看是否恢复正常。如果没问题，再逐个排查其他插件。
4. 清理缓存与环境依赖
缓存损坏也是常见坑点。在远程终端执行以下命令清除 Copilot 的本地数据：
rm -rf ~/.vscode-server/data/User/globalStorage/github.copilot-*
另外，Copilot 强依赖 Node.js 环境。如果版本过旧，建议通过 nvm 升级到 LTS 版本：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
nvm install --lts
5. 版本兼容性检查
确保基础组件满足最低要求，可以用下表对照：
| 组件 | 最低要求版本 | 检查命令 |
|---|---|---|
| VSCode | 1.75+ | code --version |
| Copilot | 1.120+ | 扩展面板查看版本号 |
| SSH 连接工具 | OpenSSH 8.4+ | ssh -V |
6. 深入调试与日志
如果以上都没解决，得看看后台日志了。在设置里开启高级调试：
"github.copilot.advanced.debug": true
