VS Code GitHub Copilot 授权失败排查与修复指南

VS Code GitHub Copilot 授权失败排查与修复指南

在 VS Code 中使用 GitHub Copilot 登录时，偶尔会遇到'尚未完成授权此扩展使用 GitHub 的操作'提示。这通常意味着本地的 OAuth 会话状态与 GitHub 端不一致，或者缓存文件出现了异常。以下是经过验证的排查步骤，建议按顺序尝试。

1. 重启授权流程

首先尝试重置当前的登录状态。按下 Ctrl+Shift+P 打开命令面板，输入 GitHub: Sign In 并执行。如果浏览器未自动弹出，请手动复制显示的链接并在浏览器中完成验证码输入。

2. 清除旧授权与缓存

有时候旧的 Token 会卡住新请求。

• GitHub 端：登录 GitHub，进入 Settings → Applications → Authorized OAuth Apps，撤销 Visual Studio Code 相关的授权。
• 本地端：退出 VS Code 会话（GitHub: Log Out），然后清理缓存文件夹。
  • Windows: %USERPROFILE%\AppData\Roaming\Code\User\globalStorage\github.vscode-pull-request-github
  • macOS/Linux: ~/.vscode/extensions/github.vscode-pull-request-github-*/data

3. 检查网络与代理

国内环境下，防火墙或代理设置常导致连接中断。确保网络通畅，并在 VS Code 设置中搜索 Proxy 确认配置是否正确。

4. 使用个人访问令牌（PAT）

如果 OAuth 始终无法通过，可以使用 PAT 作为备选方案。

1. 在 GitHub Developer settings 生成新 Token，勾选 repo、workflow 权限。
2. 在 VS Code 登录界面输入用户名后，将 PAT 粘贴为密码。

5. 查看日志与重置

若以上均无效，可在 View → Output 面板中选择 GitHub Authentication 查看详细错误堆栈。必要时可卸载并重装 GitHub Pull Requests and Issues 扩展，或重置 VS Code 配置。

完成上述操作后，大多数情况下即可恢复正常登录。