GitHub Copilot 常见问题排查 - GitHub 文档

有关 GitHub Copilot 的一般使用、产品影响、人为监督和隐私的疑问，请参阅完整的 GitHub Copilot 常见问题解答列表。

如果 GitHub Copilot 停止工作，请查看 GitHub 的状态页面，了解是否有活动中的事件。

无法在 IDE 中使用 GitHub Copilot 扩展

我们建议您在机器上设置 GitHub Copilot 时，遵循 GitHub Copilot 的快速入门指南。欲了解更多信息，请参阅 GitHub Copilot 快速入门。

GitHub Copilot 扩展会频繁更新以修复错误并添加新功能。保持扩展为最新至关重要，因为旧版客户端无法与 GitHub Copilot 服务器通信。请在所有安装了该扩展的机器上更新 GitHub Copilot 扩展。

如果您在 GHE.com 上使用托管用户账户的 Copilot 计划，则需要在登录前更新某些设置。请参阅在 GHE.com 上使用 GitHub Copilot。

欲了解在受支持的 IDE 中配置 GitHub Copilot 的更多信息，请参阅在您的环境中配置 GitHub Copilot。

GitHub Copilot 在某些文件中无法工作

如果您使用的是 Copilot Business 或 Copilot Enterprise 许可证，可能会在某些文件的编辑器中看不到内联建议。这是因为该文件被排除在 GitHub Copilot 使用范围之外。内容排除可由仓库管理员或组织所有者配置。

当文件受到内容排除设置影响时，GitHub Copilot 将不会在该文件中提供内联建议，且该文件的内容也不会用于为其他文件生成内联建议。

如果文件已被配置为 GitHub Copilot 的排除内容，状态栏中的图标会出现一条对角线。将鼠标悬停在图标上可看到提示，说明是哪项设置施加了此限制。

Screenshot of the Copilot icon in VS Code with a tooltip for a content exclusion.

欲了解更多信息，请参阅从 GitHub Copilot 中排除内容。

GitHub Copilot 内容排除未生效

内容排除可以在仓库级别和组织级别进行配置。排除的范围取决于规则设置的层级。

仓库管理员可以为其自己的仓库排除内容。这会影响企业中在这些特定仓库内使用 Copilot 的所有用户。
组织所有者可以为通过组织分配了 Copilot 许可证的用户排除内容。

在添加或更改内容排除后，可能需要最长 30 分钟才能在已加载设置的 IDE 中生效。您可以在自己的 IDE 中强制重新加载内容排除设置。欲了解更多信息，请参阅从 GitHub Copilot 中排除内容。

注意

Copilot 仍可能间接使用被排除文件的语义信息，例如 IDE 提供的类型信息、符号悬停定义以及项目的通用属性（如构建配置信息等）。

错误：“GitHub Copilot 无法连接到服务器。扩展激活失败”

此错误表明您没有 Copilot 计划，或在连接 GitHub API 请求使用 GitHub Copilot 的令牌时出现错误。

要从 api.github.com 请求另一个令牌，请尝试在 IDE 中退出再登录 Copilot。注销后，Copilot 会提示您重新登录。

如果无法连接服务器，您可以在我们的讨论论坛创建讨论。您可以附上 IDE 的日志文件以帮助我们排查问题。有关在特定 IDE 中获取日志文件的更多信息，请参阅在您的环境中查看 GitHub Copilot 日志。

Copilot 未提供多行代码建议

这是已知问题，我们的团队正在努力修复。更多信息请参阅 GitHub 社区讨论中的此评论。

错误：“抱歉，您的请求已被限流。”

此错误表明您已超出 Copilot 请求的速率限制。GitHub 通过速率限制确保所有人均能公平使用 Copilot 服务，并防止滥用。

大多数人在使用预览模型时会遇到限流，因为容量有限。

服务层面的请求速率限制确保所有 Copilot 用户都能获得高质量服务，通常不会影响一般或高度活跃的使用场景。我们已注意到部分用例受此影响，GitHub 正在迭代 Copilot 的限流算法，以确保不会阻断合法使用情况。

如果您在 Copilot 中频繁遇到限流，请联系 GitHub 支持。

在我的 IDE 中找不到 Copilot Chat

如果在编辑器中找不到 Copilot Chat，请确保已查看在 IDE 中使用 GitHub Copilot 提问的“先决条件”章节。

注意

链接的文章提供了多个 IDE 的标签页。

托管用户账户的身份验证问题

如果您在 GHE.com 上使用托管用户账户的 Copilot 计划，则需要在登录前更新某些设置。请参阅在 GHE.com 上使用 GitHub Copilot。

Visual Studio Code 中的身份验证问题

如果您已登录 GitHub，但在 Visual Studio Code 中无法使用 Copilot，可能是身份验证问题导致。请尝试以下步骤来解决此问题。

在 Visual Studio Code 窗口左下角，点击账户图标，将鼠标悬停在您的 GitHub 用户名上，然后点击 退出登录 按钮。
要重新加载 Visual Studio Code，请按 F1 打开命令面板，然后选择 Developer: Reload Window（开发者：重新加载窗口）。
Visual Studio Code 重新加载后，重新登录您的 GitHub 账户。

Visual Studio 中的身份验证问题

如果在 Visual Studio 中使用 Copilot Chat 时遇到身份验证问题，请尝试以下步骤来解决。

检查您在 Visual Studio 中登录的 GitHub ID 是否与已获得 Copilot Chat 访问权限的账号相同。
检查您的 GitHub ID/凭据是否需要在 Visual Studio 中刷新。更多信息请参阅 Visual Studio 文档中的在 Visual Studio 中使用 GitHub 账户。
尝试从 Visual Studio 中移除并重新添加您的 GitHub ID，然后重启 Visual Studio。
如果上述步骤仍未解决，请点击 分享反馈 按钮，选择 报告问题，向 Visual Studio 团队报告此问题。

GitHub.com 上的聊天响应被中断

如果聊天响应在完成前意外中止，请尝试重新提交问题。

在 Copilot Chat（github.com/copilot）中，您可以通过点击聊天响应下方的按钮重新提交问题。

排查 GitHub Copilot 常见问题

本文内容