VS Code 远程连接后 GitHub Copilot 失效排查流程

当使用 VS Code 远程开发时遇到 Copilot 代码提示消失，可按以下步骤排查：

1. 验证远程环境插件状态

• 在远程连接的 VS Code 中打开扩展面板 (Ctrl+Shift+X)
• 确认 GitHub Copilot 和 GitHub Copilot Chat 扩展已安装且启用
• 检查扩展图标状态：
  • 正常状态：状态栏右下角显示 Copilot 图标
  • 异常状态：图标灰显或出现警告三角

2. 检查网络连接

# 在远程终端测试 Copilot 服务连通性
ping copilot-proxy.githubusercontent.com
curl -v https://api.github.com/copilot

• 若出现超时或连接拒绝，需解决网络问题：
  • 检查防火墙是否屏蔽 github.com 相关域名
  • 测试代理设置（如有使用）：

    // settings.json
    "http.proxy": "http://proxy.example.com:8080"
    

3. 重新认证 Copilot

• 执行命令面板操作 (Ctrl+Shift+P)：
  • 输入 Copilot: Sign Out 退出当前账号
  • 输入 Copilot: Sign In 重新登录
• 完成浏览器认证流程后，观察状态栏图标变化

4. 验证订阅状态

• 访问 GitHub Copilot 订阅页面
• 确认：
  • 订阅处于有效状态
  • 当前远程使用的账号已绑定订阅

5. 重置扩展配置

• 清除本地缓存：

  # 删除 Copilot 缓存文件 (路径示例)
  rm ~/.vscode-server/data/User/globalStorage/github.copilot-*
  

• 重置扩展设置：

  // settings.json
  "github.copilot.enable": {
     "*": true,       // 所有语言启用
     "plaintext": false // 按需配置
  }
  

6. 更新关键组件

7. 诊断日志分析

• 启用 Copilot 日志：

  // settings.json
  "github.copilot.advanced.debug.testOverrideProxyUrl": true
  

• 查看输出面板 (Ctrl+Shift+U) 选择 GitHub Copilot 日志
• 重点关注 ERR_CONNECTION_REFUSED 或 AUTH_FAILURE 类错误

终极解决方案：
若以上步骤无效，尝试创建新的 SSH 连接配置：

Host new-remote
  HostName your.server.ip
  User devuser
  IdentityFile ~/.ssh/new_key
  ForwardAgent yes

通过全新环境隔离可能的配置冲突。

典型问题统计（根据社区反馈）：

• 约 60% 由网络问题引起
• 25% 因身份认证失效
• 10% 因扩展版本冲突
• 5% 需完全重建开发环境

建议按顺序执行排查步骤，多数情况可在步骤 3 前解决。