本文只针对 VS Code 中的 GitHub Copilot
记录 VS Code 与相关扩展版本、当前 GitHub 账号和完整错误。Cursor 账号、普通 GitHub 网页会话与 Copilot 权益不是同一个状态;不要把一种产品的缓存目录套用到另一种产品。
| 现象 | 优先检查 |
|---|---|
| 扩展要求登录或反复认证 | 编辑器中的 GitHub 身份与认证状态 |
| 账号已登录但无可用权益 | 当前账号方案或组织分配 |
| 超时或连接诊断失败 | 编辑器进程实际访问服务的路径 |
| 明确提示达到限额 | 按页面的限额和重试提示处理 |
| 只有部分文件没有建议 | 文件或组织策略,不先重装网络组件 |
先核对版本与真正登录的账号
- 在 VS Code Accounts 菜单检查 GitHub 账号,确认它是获得 Copilot 使用权限的那个账号。浏览器中另一个账号登录正常不能替代这项检查。
- 核对 VS Code 和扩展兼容性,按官方支持范围更新;组织管理的版本由管理员安排,不通过任意降级碰运气。
- 公司账号存在授权或策略提示时,将完整错误交管理员确认;不要为了排错退出组织或反复购买方案。
认证异常时刷新一次编辑器会话
确认能重新登录并保存工作后,按官方步骤从 Accounts 中退出对应 GitHub 账号,打开命令面板执行 Developer: Reload Window,再登录原账号。此操作会影响该编辑器的相关账号会话,不需要删除整个用户配置目录。
若明确提示达到限额,按服务提示等待或查看使用情况;重复退出登录不能证明限额已经解除。浏览器授权成功但扩展仍失败时,继续查看本次扩展错误。
连接失败时查看日志与 Reachability
- 从 View → Output 打开输出,在下拉列表选择对应 GitHub Copilot 输出项,记录故障时间附近的错误。
- 打开命令面板,执行 Developer: Chat Diagnostics,查看 Reachability 中需要的服务是否可达。没有该入口时先记录版本和未完成项,不把缺结果写成正常。
- 需要更详细日志时,通过 Developer: Set Log Level 临时调整对应 GitHub 扩展到 Trace,复现一次并收集必要信息,然后恢复 Info。
网页与编辑器可能采用不同连接设置,浏览器正常不能替代编辑器诊断。遇到证书错误,应由管理员核对系统信任和企业代理,不把关闭证书验证作为长期修复。日志可能涉及项目路径和请求信息,分享前脱敏。
验收与恢复
- 在不含敏感代码、组织允许使用 Copilot 的测试文件中,验证原来失败的功能。聊天与行内建议分开测试,某一项成功不代表所有功能正常。
- 重新加载窗口后确认仍是原账号,错误不再复现;保留限额或组织限制的真实状态。
- 恢复临时日志等级和连接设置。需要支持时提交版本、错误时间、功能类型和脱敏诊断,不上传完整私有代码或凭据。