VS Code 中 GitHub Copilot 无法使用？核心排查与修复指南

遇到 Copilot 安装后不工作的情况确实让人头疼。这通常不是单一原因造成的，而是网络、授权或配置的综合问题。下面按排查优先级整理了一些实战经验。

基础环境确认

首先确保你的开发环境没有硬伤。VS Code 版本最好保持在 1.60 以上，旧版对 Copilot 的支持可能不完整。打开左侧活动栏，找到那个飞机图标，确认它显示'已登录'且状态为'启用'。另外，Copilot 需要访问 GitHub 的 API，如果你开了代理或防火墙规则严格，记得放行 api.github.com。

核心配置操作

很多时候问题出在令牌（Token）上。如果之前登录过但后来失效了，直接重置往往比重新登录更有效。

打开命令面板（Ctrl+Shift+P），依次执行以下指令：

GitHub Copilot: Check Status —— 先看看到底卡在哪一步。
GitHub Copilot: Reset GitHub Copilot Token —— 刷新授权凭证。
Developer: Reload Window —— 强制重载窗口应用新配置。

如果上述操作后依然没反应，可能需要手动调整设置文件。在 settings.json 里补充以下配置，确保 Copilot 在所有语言文件中都能激活：

{
  "github.copilot.enable": {
    "*": true,
    "plaintext": true
  },
  "github.copilot.advanced": {
    "debug": true
  }
}

开启调试模式有助于后续定位问题。

冲突排查与重装

有时候并不是 Copilot 本身的问题，而是被其他 AI 插件干扰了。比如 Tabnine 这类工具可能会抢占触发键位。试着禁用其他 AI 类扩展，逐个排查冲突源。同时检查权限，普通用户权限运行 VS Code 通常比管理员更稳定。

如果还是不行，那就彻底一点。卸载扩展后，手动清理缓存文件夹：

Windows: %USERPROFILE%\.vscode\extensions\github.copilot-*
macOS/Linux: ~/.vscode/extensions/github.copilot-*

重启 VS Code 再装一次。

常见错误速查

现象	处理建议
提示未登录	执行 `GitHub Copilot: Sign In`
建议框空白	关闭 `Editor: Suggest On Trigger Characters` 后重启
响应延迟高	减少建议数量 `"github.copilot.suggestionsCount": 3`

最后，新建一个 .js 文件输入函数声明测试一下，看是否能自动补全。如果问题依旧，去 GitHub Copilot 设置页确认订阅状态，并留意 GitHub 状态页是否有服务波动。收集输出面板（Ctrl+Shift+U）中的日志提交官方支持也是个好办法。