此故障排除指南包括解决 Visual Studio 2022 版本 17.10 或更高版本中的 GitHub Copilot 问题的步骤。
如果在 Visual Studio 右上角将鼠标指针悬停在 GitHub Copilot 徽章上时,出现“Copilot 暂时无法访问”消息,则此时 GitHub 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 会退回到文件和命令行方法。
如果发生此行为,请使用以下解决方法:
- 在Copilot 对话助手中打开“工具”面板,并在选择自定义代理后重新启用所需的工具组。
- 如果每次后续回复后所选内容都会被重置,请在每轮消息中重新启用所需的组。
- 确认在工具>选项>GitHub>Copilot中启用了 MCP 集成,并在或
.vs/mcp.json中.mcp.json验证 MCP 服务器配置。
目前尚无已确认可用的产品修复方案。
用于诊断和升级处理:
- 打开“输出”窗口并选择GitHub Copilot。
- 捕获代理选择日志和至少一条后续消息。
- 请提供你的 Visual Studio 版本、Copilot 对话助手 扩展版本,以及日志中是否显示了诸如
MCP sources changed或身份验证/会话重置之类的条目。 - 从Visual Studio报告问题,并在Visual Studio 开发者社区中共享相同的详细信息。
已禁用 Copilot
管理员可能已为个别用户或所有 Copilot 许可证禁用 GitHub Copilot。 使用 Visual Studio 版本 17.10,管理员可以禁用 Copilot。
行动: 请联系 IT 部门,确认管理员是否已禁用 Copilot。
发送反馈
- 从 Visual Studio IDE 或安装程序向我们报告问题。 借助内置的反馈工具,可以轻松添加诊断信息,帮助Visual Studio团队诊断并解决问题。
- 建议一项功能、跟踪产品问题,并在 Visual Studio 开发人员社区中找到答案。