本文只针对 VS Code 中的 GitHub Copilot

记录 VS Code 与相关扩展版本、当前 GitHub 账号和完整错误。Cursor 账号、普通 GitHub 网页会话与 Copilot 权益不是同一个状态;不要把一种产品的缓存目录套用到另一种产品。

现象优先检查
扩展要求登录或反复认证编辑器中的 GitHub 身份与认证状态
账号已登录但无可用权益当前账号方案或组织分配
超时或连接诊断失败编辑器进程实际访问服务的路径
明确提示达到限额按页面的限额和重试提示处理
只有部分文件没有建议文件或组织策略,不先重装网络组件

先核对版本与真正登录的账号

  1. 在 VS Code Accounts 菜单检查 GitHub 账号,确认它是获得 Copilot 使用权限的那个账号。浏览器中另一个账号登录正常不能替代这项检查。
  2. 核对 VS Code 和扩展兼容性,按官方支持范围更新;组织管理的版本由管理员安排,不通过任意降级碰运气。
  3. 公司账号存在授权或策略提示时,将完整错误交管理员确认;不要为了排错退出组织或反复购买方案。

认证异常时刷新一次编辑器会话

确认能重新登录并保存工作后,按官方步骤从 Accounts 中退出对应 GitHub 账号,打开命令面板执行 Developer: Reload Window,再登录原账号。此操作会影响该编辑器的相关账号会话,不需要删除整个用户配置目录。

若明确提示达到限额,按服务提示等待或查看使用情况;重复退出登录不能证明限额已经解除。浏览器授权成功但扩展仍失败时,继续查看本次扩展错误。

连接失败时查看日志与 Reachability

  1. 从 View → Output 打开输出,在下拉列表选择对应 GitHub Copilot 输出项,记录故障时间附近的错误。
  2. 打开命令面板,执行 Developer: Chat Diagnostics,查看 Reachability 中需要的服务是否可达。没有该入口时先记录版本和未完成项,不把缺结果写成正常。
  3. 需要更详细日志时,通过 Developer: Set Log Level 临时调整对应 GitHub 扩展到 Trace,复现一次并收集必要信息,然后恢复 Info。

网页与编辑器可能采用不同连接设置,浏览器正常不能替代编辑器诊断。遇到证书错误,应由管理员核对系统信任和企业代理,不把关闭证书验证作为长期修复。日志可能涉及项目路径和请求信息,分享前脱敏。

验收与恢复

  1. 在不含敏感代码、组织允许使用 Copilot 的测试文件中,验证原来失败的功能。聊天与行内建议分开测试,某一项成功不代表所有功能正常。
  2. 重新加载窗口后确认仍是原账号,错误不再复现;保留限额或组织限制的真实状态。
  3. 恢复临时日志等级和连接设置。需要支持时提交版本、错误时间、功能类型和脱敏诊断,不上传完整私有代码或凭据。