VS Code 远程连接服务器后 GitHub Copilot 无法使用的解决方案

解决 VS Code 远程连接服务器后 GitHub Copilot 无法使用问题

当使用 VS Code 远程功能（如 SSH 或容器）连接服务器时，GitHub Copilot 可能因网络、扩展安装或身份验证问题失效。请按照以下步骤排查。

步骤 1：确认本地 Copilot 正常工作

在开始远程连接前，先确保 Copilot 在本地 VS Code 中工作正常。

• 打开本地 VS Code。
• 创建一个新文件（如 test.py），输入代码（如 def hello():），观察是否提供建议。
• 如果本地不工作：
  • 检查 Copilot 扩展是否已安装：在扩展商店搜索 "GitHub Copilot" 并安装。
  • 确保已登录 GitHub 账号：点击 VS Code 左下角的账户图标进行登录。
  • 重启 VS Code 后测试。

如果本地工作正常但远程失效，说明问题出在远程环境。

步骤 2：检查远程服务器的网络连接

Copilot 需要访问 GitHub API（如 https://api.github.com）。使用终端测试网络。

• 在远程 VS Code 中打开终端（快捷键 `Ctrl+``）。
• 如果 ping 失败：
  • 检查服务器防火墙设置：确保端口 443（HTTPS）未被阻止。
• 测试 GitHub API 连接：

curl -I https://api.github.com

如果返回 200 OK，说明连接正常。

如果服务器使用代理，在终端设置代理变量：

export http_proxy=http://proxy-ip:port
export https_proxy=http://proxy-ip:port

运行 ping 命令测试互联网连接：

ping -c 4 google.com

步骤 3：在远程环境中安装或启用 Copilot 扩展

VS Code 的远程会话需要单独安装扩展。

• 在远程 VS Code 中：
  • 打开扩展视图（快捷键 Ctrl+Shift+X）。
  • 搜索 "GitHub Copilot"。
  • 如果未安装，点击 "Install" 按钮；如果已安装但未启用，点击 "Enable"。
• 重启远程 VS Code：关闭所有窗口，重新连接服务器。

步骤 4：在远程环境中重新登录 GitHub 账号

Copilot 的身份验证是环境独立的。

• 在远程 VS Code 中：
  • 点击左下角的账户图标。
  • 选择 "Sign in to GitHub..." 并按照提示登录。
  • 完成后，检查状态栏右下角是否显示 "GitHub Copilot" 已激活。
• 如果登录失败，尝试清除缓存：

rm -rf ~/.vscode-server/data/User/globalStorage/github.copilot*

步骤 5：验证 VS Code 设置

某些设置可能干扰 Copilot 在远程环境中的行为。

• 在远程 VS Code 中，打开设置（快捷键 Ctrl+,）。
• 搜索 "copilot"，检查以下关键设置：