在环境中配置 GitHub Copilot

关于 JetBrains IDE 中的 GitHub Copilot

如果使用 JetBrains IDE， GitHub Copilot 可帮助你完成各种任务，包括生成代码建议、说明编辑器中的代码的工作原理以及建议代码修复。 安装后，可以启用或禁用 GitHub Copilot，并且可以在 IDE 或 ON GitHub中配置高级设置。 本文介绍如何在 IntelliJ IDE 中配置 GitHub Copilot ，但其他 JetBrains IDE 的用户界面可能有所不同。

Prerequisites

若要在 JetBrains IDE 中配置 GitHub Copilot ，必须安装 GitHub Copilot 该插件。 有关详细信息，请参阅 在环境中安装 GitHub Copilot 扩展。

启用或禁用 GitHub Copilot

可以在 JetBrains IDE 中启用或禁用 GitHub Copilot 。 GitHub Copilot JetBrains 窗口底部面板中的状态图标指示是GitHub Copilot启用或禁用的。 启用后，将突出显示图标。 禁用后，图标灰显。

1. 若要启用或禁用 GitHub Copilot，请单击 JetBrains 窗口右侧底部面板中的状态图标。

   

2. 如果您要禁用 GitHub Copilot，系统会询问您是要全局禁用它，还是仅对您当前正在编辑的文件所使用的语言禁用它。 要全局禁用，请单击“禁用完成”****。 或者，单击对应语言的按钮，为指定语言禁用 GitHub Copilot。

   

重新绑定键盘快捷方式

使用 GitHub Copilot 时，你可以在 JetBrains IDE 中使用内联建议的默认快捷键。 有关默认键盘快捷方式的列表，请参阅 IDE 中GitHub Copilot 的键盘快捷方式。

或者，可以将快捷方式重新绑定到每个特定命令的首选键盘快捷方式。 有关在 JetBrains IDE 中重新绑定键盘快捷方式的详细信息，请参阅 JetBrains 文档。 例如，可以查看 IntelliJ IDEA 文档。

为GitHub Copilot配置高级设置

您可以在 JetBrains IDE 中管理 GitHub Copilot 的高级设置，例如 IDE 如何显示内联建议，以及为 GitHub Copilot 启用或禁用哪些语言。

1. 在 JetBrains IDE 中，单击“文件”**** 菜单 (Windows) 或菜单栏中的应用程序名称 (macOS)，然后单击“设置”****。

2. 在左侧栏中，单击 工具，单击 GitHub Copilot，并查看常规和补全设置。

3. 根据个人首选项编辑设置。

   • 要调整代码建议的行为和外观，以及是否自动检查更新，请选中或取消选中相应的复选框。
   • 如果已选择接收自动更新，可以选择是接收稳定但频率较低的更新，还是接收可能不太稳定的夜间更新。 单击“更新通道”**** 下拉菜单，选择“稳定版”**** 以获取稳定更新，或选择“夜间版”**** 以获取夜间更新。

为 GitHub Copilot 配置语言设置

你可以在 IDE 中，或通过编辑你的 github-copilot.xml 文件，指定要激活或停用 GitHub Copilot 的语言。 如果在 IDE 中更改语言设置，可以单独选择和取消选择要激活或停用的语言。

如果对文件中的语言设置 github-copilot.xml 进行更改，可以指定各个语言，也可以使用通配符为所有语言激活或停用 GitHub Copilot 。 还可以指定例外，用以替代指定语言的通配符设置。 例如，可以对除 Python 和 YAML 外的所有语言停用 GitHub Copilot。 默认情况下，安装 GitHub Copilot 扩展时，GitHub Copilot 会对所有语言启用。

在 IDE 中配置语言设置

1. 在 JetBrains IDE 中，单击“文件”**** 菜单 (Windows) 或菜单栏中的应用程序名称 (macOS)，然后单击“设置”****。

2. 在左侧栏中，单击 工具，单击 GitHub Copilot，然后单击“ 完成”。

3. 在“语言”下，选中或取消选中要为其激活或停用 GitHub Copilot 的语言的复选框。

4. 单击“应用”，然后单击“确定”。

5. 重启 JetBrains IDE 让更改生效。

编辑 github-copilot.xml 文件

若要在 github-copilot.xml 文件中配置语言设置，必须编辑 languageAllowList。 添加到 languageAllowList 的每一行都必须包含一个条目键和一个值。 条目键表示语言名称，(*) 表示通配符。 该值为 true 或 false。 如果该值为 true，则会针对指定语言激活 GitHub Copilot。 如果该值为 false，则会针对指定语言停用 GitHub Copilot。

文件所处目录如下所示：

• macOS：~/Library/Application Support/JetBrains/<product><version>/options/github-copilot.xml
• Windows：%APPDATA%\JetBrains\<product><version>\options\github-copilot.xml
• Linux：~/.config/JetBrains/<product><version>/options/github-copilot.xml

例如，如果在 macOS 上使用 IntelliJ IDEA 2021.1，该文件位于 ~/Library/Application Support/JetBrains/IdeaIC2021.1/options/github-copilot.xml。

在 IDE 设置中更改默认语言配置之前，可能不会生成 github-copilot.xml 文件。 如果找不到该文件，则应尝试在 IDE 中修改默认语言设置。 有关更多信息，请参阅在 IDE 中配置语言设置。

另外，可以手动创建文件，并将文件保存在上述操作系统的相应位置。 有关更多信息，请参阅示例语言配置。

1. 在文本编辑器中打开 github-copilot.xml 文件。

2. 在 <map> 标记之间，为要启用或停用 GitHub Copilot 的语言添加一行或多行。 例如，若要对所有语言停用 GitHub Copilot：

   XML

   <entry key="*" value="false" />
   

3. 保存对 github-copilot.xml 文件的更改。

4. 重启 JetBrains IDE 让更改生效。

语言配置示例

github-copilot.xml 文件的默认配置如下，该配置会为所有语言启用 GitHub Copilot：

<application>
  <component name="github-copilot">
    <languageAllowList>
      <map>
        <entry key="*" value="true" />
      </map>
    </languageAllowList>
  </component>
</application>

<application>
  <component name="github-copilot">
    <languageAllowList>
      <map>
        <entry key="*" value="true" />
      </map>
    </languageAllowList>
  </component>
</application>

若要停用 GitHub Copilot 所有语言，通配符 （*） 值将更改为 false：

<application>
  <component name="github-copilot">
    <languageAllowList>
      <map>
        <entry key="*" value="false" />
      </map>
    </languageAllowList>
  </component>
</application>

<application>
  <component name="github-copilot">
    <languageAllowList>
      <map>
        <entry key="*" value="false" />
      </map>
    </languageAllowList>
  </component>
</application>

若要单独指定语言，请为要为其激活或停用 GitHub Copilot 的每种语言添加一个条目。 特定语言设置将覆盖通配符。 例如，若要为 Python 和 YAML 激活GitHub Copilot，并停用GitHub Copilot所有其他语言，请添加以下条目：

<application>
  <component name="github-copilot">
    <languageAllowList>
      <map>
        <entry key="*" value="false" />
        <entry key="Python" value="true" />
        <entry key="YAML" value="true" />
      </map>
    </languageAllowList>
  </component>
</application>

<application>
  <component name="github-copilot">
    <languageAllowList>
      <map>
        <entry key="*" value="false" />
        <entry key="Python" value="true" />
        <entry key="YAML" value="true" />
      </map>
    </languageAllowList>
  </component>
</application>

还可以添加配置，让 languageAllowList 在 IDE 的设置中变为只读。 此举可阻止更改 IDE 中的语言设置。 例如：

<application>
  <component name="github-copilot">
    <option name="languageAllowListReadOnly" value="true" />
    <languageAllowList>
      <map>
        <entry key="*" value="true" />
      </map>
    </languageAllowList>
  </component>
</application>

<application>
  <component name="github-copilot">
    <option name="languageAllowListReadOnly" value="true" />
    <languageAllowList>
      <map>
        <entry key="*" value="true" />
      </map>
    </languageAllowList>
  </component>
</application>

在 Copilot 上配置 GitHub.com 设置

如果您使用的是 Copilot Pro、Copilot Pro+ 或 Copilot Max 计划，则可以选择允许或禁止与公开可用代码匹配的内联建议。 可在个人设置 GitHub.com中配置此设置。 请参阅“以个人订阅者身份管理 GitHub Copilot 策略”。

在 GHE.com 上对账户进行身份验证

如果在 Copilot 上使用 托管用户帐户 的 GHE.com 计划，则需要在登录之前更新一些设置。 请参阅 在 GHE.com 上将 GitHub Copilot 与帐户配合使用。

其他阅读材料

• GitHub Copilot 常见问题