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 Business,则可能无法在编辑器中看到某些文件的代码补全建议。 当 GitHub Copilot 不使用该文件时,会发生此情况。 内容排除可以由存储库管理员或组织所有者进行配置。

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

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

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

有关详细信息,请参阅“为 GitHub Copilot 配置内容排除”。

GitHub Copilot 内容排除未应用

GitHub Copilot 内容排除项设置不适用于使用 Copilot 的每个人。

内容排除项设置仅适用于以下人员:作为 GitHub Copilot Business 订阅成员已授予席位,并且是已配置内容排除项的同一企业的成员。 可访问指定文件的其他用户不会受到内容排除项的影响,并且仍会看到代码完成建议。

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

注释

  • 从 GitHub Copilot 中排除的内容目前为公开 Beta 版,可能会有变动。
  • Visual Studio、Visual Studio Code、JetBrains IDE 和 neovim 中支持此功能。 有关受支持的 JetBrains IDE 的详细信息,请参阅“开始使用 GitHub Copilot”。
  • 从 GitHub Copilot 中排除的内容目前仅影响代码完成。 GitHub Copilot Chat 不会受这些设置的影响。
  • 内容排除项可防止 Copilot 直接访问已排除文件的内容。 Copilot 可能会从 IDE 提供的语义信息(例如,类型信息或代码中所使用符号的悬停定义)中绘制有关非排除文件的信息。 IDE 可能会从排除的文件派生此信息。

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

此错误指示你没有 GitHub Copilot 订阅,或者连接到 GitHub API 来请求令牌以使用 GitHub Copilot 时出错。

若要从 api.github.com 请求另一个令牌,请尝试从你的 IDE 登录并退出登录 GitHub Copilot。 在你退出登录后,GitHub Copilot 将提示你重新登录。

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

GitHub Copilot 不建议多行代码

这是一个已知问题,我们的团队正在努力进行修复。 有关详细信息,请参阅 GitHub Community 讨论中关于这一点的评论。

延伸阅读