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 中配置代理设置。

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