跳轉到主要內容

GitHub Copilot 常见问题排查

本指南介绍了 GitHub Copilot 的最常见问题以及如何解决这些问题。

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

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

无法在 IDE 中使用 GitHub Copilot 扩展

建议您在机器上设置 GitHub Copilot 时,按照 GitHub Copilot 的快速入门指南操作。有关更多信息,请参阅“GitHub Copilot 快速入门”。

GitHub Copilot 扩展会经常更新以修复错误并添加新功能。保持扩展更新非常重要,因为旧版客户端无法与 GitHub Copilot 服务器通信。请在您安装了 GitHub Copilot 扩展的所有机器上更新您的 GitHub Copilot 扩展。

有关在支持的 IDE 中配置 GitHub Copilot 的更多信息,请参阅“在您的环境中配置 GitHub Copilot”。

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

如果您使用的是 Copilot Business 或 Copilot Enterprise 许可证的 GitHub Copilot,您可能无法在编辑器中看到某些文件的代码补全建议。当文件被排除在 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 内容排除未应用

GitHub Copilot 内容排除设置不适用于所有使用 Copilot 的用户。

内容排除设置仅适用于已获得 GitHub Copilot Business 或 GitHub Copilot Enterprise 订阅席位,并且是配置内容排除的同一组织成员的用户。其他可以访问指定文件的用户不受内容排除的影响,仍然会看到代码补全建议。

添加或更改内容排除后,可能需要长达 30 分钟才能在已加载设置的 IDE 中生效。您可以将更改应用到您自己的 IDE,强制其重新加载内容排除设置。有关更多信息,请参阅 "配置 GitHub Copilot 的内容排除。"。

注意

  • 从 GitHub Copilot 中排除内容目前处于公开测试阶段,可能会发生变化。
  • 此功能支持 Visual Studio、Visual Studio Code、JetBrains IDE 和 neovim 中的 GitHub Copilot 代码补全。它还支持 VS Code 中的 GitHub Copilot Chat。有关支持的 JetBrains IDE 的详细信息,请参阅 "在您的编辑器中使用 GitHub Copilot 代码建议。"。
  • 除了 Visual Studio Code 之外,目前不支持 GitHub Copilot Chat 的内容排除。
  • 当您在问题中使用 @github Copilot 聊天参与者时,不会在 Visual Studio Code 中的 GitHub Copilot Chat 和 Visual Studio 中的 Copilot Chat 中应用内容排除。
  • 如果 IDE 在非排除文件中提供了信息,Copilot 可能会使用来自排除文件的语义信息。此类内容的示例包括类型信息和用于代码中符号的悬停定义。

错误:"GitHub Copilot 无法连接到服务器。扩展激活失败"

此错误表示您没有 GitHub Copilot 订阅,或者在连接到 GitHub API 以请求使用 GitHub Copilot 的令牌时出现错误。

要从 api.github.com 请求另一个令牌,请尝试从您的 IDE 中登录和注销 GitHub Copilot。注销后,GitHub Copilot 会提示您重新登录。

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

GitHub Copilot 没有建议多行代码

这是一个已知问题,我们的团队正在努力解决。有关更多信息,请参阅 GitHub 社区讨论 中的此评论。

进一步阅读