在 Visual Studio 中对 GitHub Copilot 进行故障排除

此故障排除指南包括解决 Visual Studio 2022 版本 17.10 或更高版本中的 GitHub Copilot 问题的步骤。

如果在 Visual Studio 右上角将鼠标指针悬停在 GitHub Copilot 徽章上时,出现“Copilot 暂时无法访问”消息,则此时 GitHub Copilot 为离线状态。

显示 Copilot 无法访问错误的屏幕截图。

如果 Visual Studio 环境右上角的 GitHub Copilot 锁屏提醒显示 Copilot 暂时无法访问消息,则表示 GitHub Copilot 当前处于脱机状态。

Copilot 不可访问错误的屏幕截图。

由于以下原因之一,GitHub Copilot 可能处于脱机状态:

  • 网络问题
  • Copilot 服务不可用
  • 需要刷新的凭据
  • Copilot 已被禁用

如果遇到未在此列表中出现的问题,请向我们 报告你的问题 。

网络问题

如果网络已关闭,GitHub Copilot 可能无法连接。

操作: 确保 Internet 连接稳定。 有关详细信息,请参阅排查 GitHub Copilot 的网络错误。

Copilot 服务不可用

GitHub Copilot 服务可能会暂时关闭。

行动: 等待服务重新联机。 可以在 GitHub 状态上检查状态。

刷新凭据

有时,可能需要刷新凭据, 由于可能会发生超时。

操作: 从 Visual Studio 环境右上角的 Copilot 徽章中选择 刷新 GitHub 凭据,以重新验证您的 GitHub 帐户并重新登录。

“刷新凭据”选项的屏幕截图。

说明

已知问题: 如果在“ 所有帐户” 窗口中看不到刷新 GitHub 帐户凭据的选项,可以通过删除并重新添加 GitHub 帐户来解决此问题。 有关详细信息,请查阅与此问题相关的 开发社区工单。

自定义代理工具组初始为禁用状态,或在轮次之间被重置

一些用户报告说,在 Visual Studio 2026 版本 18.6.0 和 18.6.1 中使用来自 .github/agents/*.agent.md 的自定义代理时,会出现此行为,其中包括仅定义了 name 和 description 的最小代理文件。

可能的症状包括:

  • 选择自定义代理后,工具组(如 C++ 上下文或 MCP 服务器工具 )将显示为禁用状态。
  • 在同一聊天线程中,每次发送后续消息后,工具选择都会被重置。
  • 在严重情形下,由于内置选项和 MCP 选项已被清除,Copilot 会退回到文件和命令行方法。

如果发生此行为,请使用以下解决方法:

  1. 在Copilot 对话助手中打开“工具”面板,并在选择自定义代理后重新启用所需的工具组。
  2. 如果每次后续回复后所选内容都会被重置,请在每轮消息中重新启用所需的组。
  3. 确认在工具>选项>GitHub>Copilot中启用了 MCP 集成,并在或.vs/mcp.json中.mcp.json验证 MCP 服务器配置。

目前尚无已确认可用的产品修复方案。

用于诊断和升级处理:

  1. 打开“输出”窗口并选择GitHub Copilot。
  2. 捕获代理选择日志和至少一条后续消息。
  3. 请提供你的 Visual Studio 版本、Copilot 对话助手 扩展版本,以及日志中是否显示了诸如 MCP sources changed 或身份验证/会话重置之类的条目。
  4. 从Visual Studio报告问题,并在Visual Studio 开发者社区中共享相同的详细信息。

已禁用 Copilot

管理员可能已为个别用户或所有 Copilot 许可证禁用 GitHub Copilot。 使用 Visual Studio 版本 17.10,管理员可以禁用 Copilot。

行动: 请联系 IT 部门,确认管理员是否已禁用 Copilot。

编辑器中新文件中代码建议的屏幕截图。

显示 Copilot 已禁用消息的屏幕截图。

发送反馈

  • 从 Visual Studio IDE 或安装程序向我们报告问题。 借助内置的反馈工具,可以轻松添加诊断信息,帮助Visual Studio团队诊断并解决问题。
  • 建议一项功能、跟踪产品问题,并在 Visual Studio 开发人员社区中找到答案。