VS Code 远程连接服务器后 GitHub Copilot 失效排查指南

VS Code 远程连接服务器后 GitHub Copilot 失效排查法

步骤 1：验证基础连接状态

• 检查扩展安装：在远程服务器上打开 VS Code 扩展面板（Ctrl+Shift+X），确认 GitHub Copilot 扩展是否显示'已在远程安装'。若显示'在 SSH:xxx 上安装'，需点击安装。

网络连通性测试：在远程终端执行：

curl -v https://api.githubcopilot.com 

正常响应应返回 HTTP/2 403（权限拒绝），若出现连接超时或 DNS 错误，说明存在网络隔离。

步骤 2：排查认证同步问题

• 检查令牌状态：
  1. 本地 VS Code 执行 Ctrl+Shift+P > GitHub Copilot: Sign In
  2. 远程连接后执行 Ctrl+Shift+P > GitHub Copilot: Check Status 观察是否显示'已登录为 [你的账号]'。若显示'未认证'，需在远程重新登录。

密钥文件验证：检查远程服务器的 ~/.config/github-copilot/hosts.json 文件是否存在且包含有效 token。对比本地文件（路径相同）大小：

ls -l ~/.config/github-copilot/ 

步骤 3：诊断扩展冲突

• 扩展隔离测试：
  1. 创建临时配置文件：code --user-data-dir ~/tmp-vscode
  2. 仅安装 Copilot 扩展进行测试
  3. 若此时可用，说明原配置存在冲突扩展
  4. 打开 VS Code 输出面板（Ctrl+Shift+U）
  5. 选择 GitHub Copilot 日志通道
  6. 重点关注含 ERR/Cannot activate 或 ECONNRESET 的条目 典型错误示例：

查看日志输出：

[ERROR] AuthError: Missing token scopes: 'copilot' 

快速恢复方案

# 重置远程扩展缓存
rm -rf ~/.vscode-server/extensions/github.copilot-*
# 重启 VS Code 远程连接

注意：若使用企业代理，需在远程服务器的 settings.json 中添加代理配置，例如：

{
  "http.proxy": "http://proxy.example.com:8080",
  "https.proxy": "http://proxy.example.com:8080"
}

通过以上三步可定位大部分远程失效问题，核心关注点依次为：扩展状态→认证同步→网络/配置冲突。