Skip to main content

排查 GitHub Copilot 的常见问题

本指南介绍 GitHub Copilot 的最常见问题以及解决方法。

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

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

无法在 IDE 中使用 GitHub Copilot 扩展

建议在计算机上设置 GitHub Copilot 时遵循 GitHub Copilot 的快速入门指南。 有关详细信息,请参阅“GitHub Copilot 快速入门”。

GitHub Copilot 扩展会经常更新,以修复 bug 并添加新功能。 请务必使扩展保持最新状态,因为较旧版本的客户端无法与 GitHub Copilot 服务器通信。 在安装了 GitHub Copilot 扩展的所有计算机上更新它。

有关在受支持的 IDE 中配置 GitHub Copilot 的详细信息,请参阅“在环境中配置 GitHub Copilot”。

GitHub Copilot 在某些文件中不起作用

如果将 GitHub Copilot 与 Copilot Business 或 Copilot Enterprise 许可证一起使用,则某些文件的编辑器中可能不会看到代码补全建议。 当 GitHub Copilot 不使用该文件时,会发生此情况。 内容排除可以由存储库管理员或组织所有者进行配置。

当文件受到内容排除设置的影响时,GitHub Copilot 将不会在该文件中提出代码补全建议,该文件的内容也不会被用于为其他文件中的代码补全建议提供信息。

如果文件已配置为 GitHub Copilot 的排除内容,则状态栏中的图标将有一条对角线穿过。 将鼠标悬停在该图标上可看到工具提示,告知哪些设置已应用此限制。

VS Code 中 Copilot 图标的屏幕截图,其中包含内容排除的工具提示。

有关详细信息,请参阅“关于 GitHub Copilot 的内容排除功能”。

GitHub Copilot 内容排除未应用

Note

从 GitHub Copilot 中排除的内容目前为公开 Beta 版,可能会有变动。

内容排除设置仅适用于满足以下每个条件的人

  • 作为 GitHub Copilot Business 或 GitHub Copilot Enterprise 订阅的一部分,他们已被授予一个席位
  • 他们是配置了内容排除的同一的成员

任何其他可以访问指定文件的人仍将看到引用指定文件的代码完成建议和 GitHub Copilot Chat 响应。

添加或更改内容排除项后,可能需要长达 30 分钟才能在已加载设置的 IDE 中生效。 可以将更改应用于自己的 IDE,强制其重新加载内容排除设置。有关详细信息,请参阅“在 IDE 中测试对内容排除项的更改”。

注意:

  • 在 Visual Studio Code 中的 Copilot Chat 中,当在问题中使用 @github 聊天参与者时,不会应用内容排除项。
  • 如果 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 Community 讨论中关于这一点的评论。

延伸阅读