VS Code 远程连接 GitHub Copilot 失效排查指南
在使用 VS Code 的远程功能（如 SSH 或容器）连接到服务器时，GitHub Copilot 经常会出现无法提供建议的情况。这通常不是单一原因造成的，而是涉及网络连通性、扩展同步状态以及身份验证等多个环节。下面按排查顺序逐步处理，确保每一步都落到实处。
1. 确认本地环境基准
在折腾远程之前，先保证本地 VS Code 里的 Copilot 是健康的。打开本地编辑器，新建一个文件输入几行代码，看是否有智能提示。如果本地都不行，先去扩展商店重装一下 GitHub Copilot，并确保左下角账户已登录成功。只有本地正常，才能排除是账号本身的问题。
2. 检查服务器网络连通性
Copilot 依赖 GitHub API，如果服务器被防火墙拦截或无法访问外网，插件肯定罢工。在远程终端里用 curl 测试一下接口：
curl -I https://api.github.com
如果返回 200 OK，说明基础网络没问题。要是 ping 不通，得找管理员开端口 443。如果服务器走了代理，记得把环境变量设好：
export http_proxy=http://proxy-ip:port
export https_proxy=http://proxy-ip:port
这里要注意，有些公司内网的代理配置可能不生效，最好直接测一下 Google 或其他公网地址。
3. 远程环境安装与启用扩展
很多人会忽略这一点：VS Code 的远程会话需要单独安装扩展，本地装好的不会自动同步过去。在远程窗口里打开扩展视图（Ctrl+Shift+X），搜 GitHub Copilot。如果没安装就点 Install，如果已安装但显示 Disabled，点 Enable。装完重启远程窗口是个好习惯，能避免一些奇怪的缓存冲突。
4. 重新进行身份验证
远程环境的鉴权是独立的，有时候 token 会过期。点击左下角账户图标，选择 Sign in to GitHub... 重新走一遍登录流程。成功后右下角状态栏应该能看到 Copilot 激活的提示。
如果还是报错，试试清一下缓存目录：
rm -rf ~/.vscode-server/data/User/globalStorage/github.copilot*
这个命令会删除 Copilot 的本地存储数据，强制它重新拉取配置。
5. 关键配置检查
有些全局设置可能会干扰远程模式下的表现。在设置里搜索 copilot，重点看这两个：
github.copilot.enable：确保是 true。github.copilot.experimental.remote：如果是较新版本，建议开启以兼容远程特性。
可以直接在 settings.json 里添加或修改：
{
"github.copilot.enable": true,
"github.copilot.experimental.remote": true
}
改完记得保存并重启。
6. 日志与最终验证
做完以上步骤，再写个函数试试。如果依然没反应，别慌，看日志最准。打开输出面板（Ctrl+Shift+U），选 GitHub Copilot 频道，里面会有具体的错误码。Connection refused 通常是网络问题，Authentication failed 就是回去重登账号。最后检查一下权限，确保当前用户对 vscode-server 目录有读写权限。
