# 使用 GitHub Copilot 在 IDE 中获取代码建议

使用 GitHub Copilot 在编辑器中获取代码建议。

<style> .button-container { display： flex; gap： 10px; } </style><div class="button-container">

```
<a href="https://github.com/copilot?ref_product=copilot&ref_type=trial&ref_style=button&ref_plan=free" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline">
          
    <span>免费开始使用</span><svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-link-external" aria-label="link external icon" role="img"><path d="M3.75 2h3.5a.75.75 0 0 1 0 1.5h-3.5a.25.25 0 0 0-.25.25v8.5c0 .138.112.25.25.25h8.5a.25.25 0 0 0 .25-.25v-3.5a.75.75 0 0 1 1.5 0v3.5A1.75 1.75 0 0 1 12.25 14h-8.5A1.75 1.75 0 0 1 2 12.25v-8.5C2 2.784 2.784 2 3.75 2Zm6.854-1h4.146a.25.25 0 0 1 .25.25v4.146a.25.25 0 0 1-.427.177L13.03 4.03 9.28 7.78a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042l3.75-3.75-1.543-1.543A.25.25 0 0 1 10.604 1Z"></path></svg>
</a>
<div class="ghd-tool vscode">
<a href="vscode://GitHub.Copilot-Chat?ref_product=copilot&ref_type=engagement&ref_style=button" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline">
    <span>在 Visual Studio Code 中打开</span><svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-link-external" aria-label="link external icon" role="img"><path d="M3.75 2h3.5a.75.75 0 0 1 0 1.5h-3.5a.25.25 0 0 0-.25.25v8.5c0 .138.112.25.25.25h8.5a.25.25 0 0 0 .25-.25v-3.5a.75.75 0 0 1 1.5 0v3.5A1.75 1.75 0 0 1 12.25 14h-8.5A1.75 1.75 0 0 1 2 12.25v-8.5C2 2.784 2.784 2 3.75 2Zm6.854-1h4.146a.25.25 0 0 1 .25.25v4.146a.25.25 0 0 1-.427.177L13.03 4.03 9.28 7.78a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042l3.75-3.75-1.543-1.543A.25.25 0 0 1 10.604 1Z"></path></svg>
</a>
</div>
```

</div>

<div class="ghd-tool jetbrains">

## 简介

本指南演示如何从 GitHub Copilot JetBrains IDE 中获取编码建议。 要查看其他常用编码环境的说明，请使用页面顶部的工具切换器。

本指南中的示例使用 Java，但其他语言的工作方式类似。

有关详细信息，请参阅“[IDE 中的 GitHub Copilot 代码建议](/zh/copilot/concepts/completions/code-suggestions?tool=jetbrains)”。

## Prerequisites

* **Copilot访问** 。 若要在 JetBrains 中使用 GitHub Copilot ，需要通过 Copilot Free 有限访问权限或付费 Copilot 计划进行完全访问。 请参阅“[什么是GitHub Copilot？](/zh/copilot/get-started/what-is-github-copilot#get-access)”。

* **兼容的 JetBrains IDE**。
  GitHub Copilot若要在 JetBrains 中使用，必须安装兼容的 JetBrains IDE。
  GitHub Copilot 与以下 IDE 兼容：

  * IntelliJ IDEA（旗舰版、社区版、教育版）
  * Android Studio
  * CLion
  * Code With Me 来宾
  * DataGrip
  * DataSpell
  * GoLand
  * JetBrains 客户端
  * MPS
  * PhpStorm
  * PyCharm（专业版、社区版、教育版）
  * Rider
  * RubyMine
  * RustRover
  * WebStorm

  请参阅 [JetBrains IDE](https://www.jetbrains.com/products/?ref_product=copilot\&ref_type=engagement\&ref_style=button) 工具查找器进行下载。

* **最新版本的 GitHub Copilot 扩展**。 请在 JetBrains Marketplace 中查看[GitHub Copilot插件](https://plugins.jetbrains.com/plugin/17718-github-copilot?ref_product=copilot\&ref_type=engagement\&ref_style=text)。 有关安装说明，请参阅“[在环境中安装 GitHub Copilot 扩展](/zh/copilot/how-tos/set-up/install-copilot-extension?tool=jetbrains)”。

* **登录到 GitHub JetBrains IDE**。 有关身份验证说明，请参阅“[在环境中安装 GitHub Copilot 扩展](/zh/copilot/how-tos/set-up/install-copilot-extension?tool=jetbrains#installing-the-github-copilot-plugin-in-your-jetbrains-ide)”。

## 获取代码建议

GitHub Copilot 键入时提供编码建议。 例如，在一个 Java 文件中，键入 `class Test` 以创建一个类。

GitHub Copilot 会以灰色文本自动建议一个类主体。 要接受建议，请按 <kbd>Tab</kbd>。

你还可以在注释中使用自然语言描述你想要执行的操作，Copilot 将建议可实现你目标的代码。 例如，在一个 Java 文件中键入此注释：

```java copy
// find all images without alternate text
// and give them a red border
void process () {
```

GitHub Copilot 将自动建议代码。 要接受建议，请按 <kbd>Tab</kbd>。

GitHub Copilot 将尝试匹配代码的上下文和样式。 始终可以编辑建议的代码。

> \[!TIP]
> 如果你从 Copilot 收到的建议很少或根本没有建议，则可能是启用了重复检测功能。 有关重复检测的详细信息，请参阅 [以个人订阅者身份管理 GitHub Copilot 策略](/zh/copilot/how-tos/manage-your-account/manage-policies#enabling-or-disabling-suggestions-matching-public-code)。

## 显示替代建议

对于任何给定的输入，GitHub Copilot 可以提供多个建议。 可以选择要使用的建议，或拒绝所有建议。

例如，在一个 Java 文件中键入下面这一行内容，然后按 <kbd>Enter</kbd>：

```java copy
private int calculateDaysBetweenDates(Date date1,
```

GitHub Copilot 将向您显示一条建议。

现在，将鼠标悬停在建议上以显示 GitHub Copilot 用于选择建议的控件。 要显示下一批或上一批建议，请单击控件中的向前或向后箭头按钮。

也可以使用键盘快捷方式显示替代建议：

| OS                           | 查看下一个建议 | 查看上一个建议 |
| :--------------------------- | :------ | :------ |
| macOS                        |         |         |
| <kbd>选择</kbd>+<kbd>]</kbd>   |         |         |
| <kbd>选择</kbd>+<kbd>\[</kbd>  |         |         |
| Windows 或 Linux              |         |         |
| <kbd>Alt</kbd>+<kbd>]</kbd>  |         |         |
| <kbd>Alt</kbd>+<kbd>\[</kbd> |         |         |

要接受建议，请单击 Copilot 命令面板中的“接受”，或按 <kbd>Tab</kbd>。要拒绝所有建议，请按 <kbd>Esc</kbd>。

## 在新选项卡中显示多个建议

如果不想使用 GitHub Copilot 提供的任何初始建议，可以在新选项卡中显示多个建议。

例如，在一个 Java 文件中键入下面这一行内容：

```java copy
private int calculateDaysBetweenDates(Date date1,
```

GitHub Copilot 将向您显示一条建议。

若要打开具有多个其他建议的新选项卡，请使用以下键盘快捷方式，然后单击“ **打开 GitHub Copilot**” ：

| OS                                            | 打开多个建议 |
| :-------------------------------------------- | :----- |
| macOS                                         |        |
| <kbd>命令键</kbd>+<kbd>Shift键</kbd>+<kbd>A</kbd> |        |
| Windows 或 Linux                               |        |
| <kbd>Ctrl</kbd>+<kbd>进入</kbd>                 |        |

要接受建议，请单击建议下方的“**接受建议编号**”。 若要拒绝所有建议，请关闭选项卡。

## 接受部分建议

如果您不想接受来自 GitHub Copilot 的整条建议，则可以接受建议中的下一个单词或下一行。

例如，在一个 Java 文件中键入下面这一行内容：

```java copy
private int calculateDaysBetweenDates(Date date1,
```

GitHub Copilot 将以灰色文本显示建议。 具体的建议可能会有所不同。

现在，将鼠标悬停在建议上以显示 GitHub Copilot 用于选择建议的控件。 要只接受建议的下一个单词，请单击控件中的“接受单词”。\*\*\*\*

或者，也可以使用键盘快捷方式接受建议的下一个单词：

| OS                                        | 接受下一个字词 | 接受下一行 |
| :---------------------------------------- | :------ | :---- |
| macOS                                     |         |       |
| <kbd>命令</kbd>+<kbd>→</kbd>                |         |       |
| <kbd>命令</kbd>+<kbd>控制</kbd>+<kbd>→</kbd>  |         |       |
| Windows 或 Linux                           |         |       |
| <kbd>控制</kbd>+<kbd>→</kbd>                |         |       |
| <kbd>控制</kbd>+<kbd>Alt</kbd>+<kbd>→</kbd> |         |       |

如果希望接受下一行建议，则需要为命令 `editor.action.inlineSuggest.acceptNextLine` 设置自定义键盘快捷方式。 有关设置自定义键盘快捷方式的详细信息，请参阅 [在环境中配置 GitHub Copilot](/zh/copilot/how-tos/configure-personal-settings/configure-in-ide)。

</div>

<div class="ghd-tool visualstudio">

## 简介

本指南演示如何在适用于 Windows 的GitHub Copilot中从Visual Studio获取代码建议。 要查看其他常用编码环境的说明，请使用页面顶部的工具切换器。

本指南中的示例使用 C#，但其他语言的工作方式类似。

有关详细信息，请参阅“[IDE 中的 GitHub Copilot 代码建议](/zh/copilot/concepts/completions/code-suggestions?tool=visualstudio)”。

## Prerequisites

* **Copilot访问** 。 要在GitHub Copilot中的GitHub Copilot中使用Visual Studio，你需要通过Copilot Free获得有限访问权限，或订阅付费的Copilot方案以获得完全访问权限。 请参阅“[什么是GitHub Copilot？](/zh/copilot/get-started/what-is-github-copilot#get-access)”。

* ```
            **Visual Studio 的兼容版本**。 要在 GitHub Copilot 中使用 Visual Studio，必须安装 Visual Studio for Windows 版本 2022 17.8 或更高版本。 有关更多信息，请参阅 Microsoft 文档中的“[安装 Visual Studio](https://learn.microsoft.com/en-us/visualstudio/install/install-visual-studio?ref_product=copilot&ref_type=engagement&ref_style=text)”。
  ```

* ```
            **适用于 GitHub Copilot 的 Visual Studio 扩展**。 有关如何安装 Copilot 扩展的说明，请参阅 Microsoft 文档中的“[在 Visual Studio 中安装 GitHub Copilot](https://learn.microsoft.com/visualstudio/ide/visual-studio-github-copilot-install-and-states?ref_product=copilot&ref_type=engagement&ref_style=text)”。
  ```

* ```
            **将 GitHub 帐户添加到 Visual Studio**。 请参阅 Microsoft 文档中的[将 GitHub 帐户添加到 Visual Studio 密钥链](https://learn.microsoft.com/en-us/visualstudio/ide/work-with-github-accounts?ref_product=copilot&ref_type=engagement&ref_style=text)。
  ```

## 获取代码建议

GitHub Copilot 键入时提供编码建议。 例如，在一个 C# 文件中键入此函数签名：

```csharp copy
int CalculateDaysBetweenDates(
```

GitHub Copilot 将自动以灰色文本显示整个函数正文。 要接受建议，请按 <kbd>Tab</kbd>。

你还可以在注释中使用自然语言描述你想要执行的操作，Copilot 将建议可实现你目标的代码。 例如，在一个 C# 文件中键入此注释：

```csharp copy
using System.Xml.Linq;

var doc = XDocument.Load("index.xhml");

// find all images
```

GitHub Copilot 将建议函数的实现。 要接受建议，请按 <kbd>Tab</kbd>。

> \[!TIP]
> 如果你从 Copilot 收到的建议很少或根本没有建议，则可能是启用了重复检测功能。 有关重复检测的详细信息，请参阅 [以个人订阅者身份管理 GitHub Copilot 策略](/zh/copilot/how-tos/manage-your-account/manage-policies#enabling-or-disabling-suggestions-matching-public-code)。

## 显示替代建议

对于任何给定的输入，GitHub Copilot 可以提供多个建议。 可以选择要使用的建议，或拒绝所有建议。

例如，在一个 C# 文件中键入此函数签名：

```csharp copy
int CalculateDaysBetweenDates(
```

GitHub Copilot 将向您显示一条建议。

现在，将鼠标悬停在建议上以显示 GitHub Copilot 用于选择建议的控件。 要显示下一批或上一批建议，请单击控件中的向前或向后箭头按钮。

或者，也可以按键盘上的 <kbd>Alt</kbd>+<kbd>.</kbd> （或 <kbd>Alt</kbd>+<kbd>,</kbd>），以显示替代建议。

要接受建议，请单击 Copilot 命令面板中的“接受”，或按 <kbd>Tab</kbd>。要拒绝所有建议，请按 <kbd>Esc</kbd>。

## 获取注释建议

> \[!NOTE] 在 Visual Studio 17.14 预览版 2 及更高版本中，可使用评论建议。

GitHub Copilot 可以通过分析你编写的代码并生成描述代码作用的注释，为你的代码提供注释建议。 对于 Copilot Free 用户，评论建议计入您每月的 Copilot Chat 用量，而不是您的代码建议用量。

注释建议支持以下语言：

* C#
* C++

### 启用注释建议

若要启用批注建议，需要配置 Visual Studio批注样式。

#### 对于 C++

1. 在Visual Studio\*\*“工具”\*\* 菜单中，单击“**选项**”。
2. 在左侧面板中，单击“文本编辑器”\*\*\*\*。
3. 单击 **C++**，然后单击 **“代码样式**”。
4. 在 **“代码样式”** 标题下，单击“ **常规**”。
5. 在“Comments”下，从下拉列表中选择“Xml Doc Comments”\*\*\*\*。
6. 选择“编写注释时在新行的开头插入现有注释风格”和“继续进行单行注释”\*\*\*\*****。 然后点击**OK**。
7. 在**Options**选项卡中的左侧面板中，单击**GitHub**。
8. 单击 **“Copilot**”，然后单击 **“编辑器**”。
9. 选择**启用 AI 生成的描述，以在支持的语言中自动插入文档注释**。

#### 对于 C\#

1. 在Visual Studio\*\*“工具”\*\* 菜单中，单击“**选项**”。
2. 在左侧面板中，单击“ **语言**”。
3. 单击 **C#**，然后单击 **“更多设置”**，然后单击 **“高级**”。
4. 在“注释”下，选择**为 /// 生成 XML 文档注释**、**编写 // 注释时，请在新行的开头插入 //** 和 **编写 /\*\*/ 注释时在新行开头插入 \***。 然后点击**OK**。
5. 在**Options**选项卡中的左侧面板中，单击**GitHub**。
6. 单击 **“Copilot**”，然后单击 **“编辑器**”。
7. 选择**启用 AI 生成的描述，以在支持的语言中自动插入文档注释**。

### 使用注释建议

若要启动注释建议，请在要注释的代码之前键入编写代码所用的语言对应的标准注释起始符（例如 `///`），然后等待建议显示。

要接受建议，请按 <kbd>Tab</kbd>。若要修改建议，请按 <kbd>Alt</kbd>+<kbd>/</kbd>。 若要拒绝建议，请按 <kbd>Esc</kbd>。

## 导航与接受 next edit suggestions

根据所做的编辑， Copilot 将预测可能进行下一次编辑的位置，并建议完成该编辑。

可以使用 <kbd>Tab</kbd> 浏览建议的代码更改，从而更轻松地找到下一个相关编辑，而无需手动搜索文件或引用。 再次按 <kbd>Tab</kbd> 可接受建议。

装订线中的箭头表示有可用的编辑建议。 单击箭头以访问提供键盘快捷方式的编辑建议菜单。 如果编辑建议在当前编辑器视图之外，则箭头将向上或向下指，以指示下一条建议的位置。

</div>

<div class="ghd-tool vscode">

## 简介

本指南演示如何从 GitHub Copilot 中 Visual Studio Code获取编码建议。 要查看其他常用编码环境的说明，请使用页面顶部的工具切换器。

本指南中的示例使用 JavaScript，但其他语言的工作方式类似。

有关详细信息，请参阅“[IDE 中的 GitHub Copilot 代码建议](/zh/copilot/concepts/completions/code-suggestions?tool=vscode)”。

## Prerequisites

* **Copilot访问** 。 若要在GitHub Copilot中使用Visual Studio Code，你需要通过Copilot Free获得受限访问权限，或者订阅付费Copilot计划以获得完整访问权限。 请参阅“[什么是GitHub Copilot？](/zh/copilot/get-started/what-is-github-copilot#get-access)”。

* **在 GitHub 中登录 Visual Studio Code**。 请参阅 GitHub Copilot 文档中的VS Code

* **Visual Studio Code**。 若要在GitHub Copilot中使用Visual Studio Code，必须已安装Visual Studio Code。 有关详细信息，请参阅 [Visual Studio Code 下载页](https://code.visualstudio.com/Download?ref_product=copilot\&ref_type=engagement\&ref_style=text)。

* **Copilot in Visual Studio Code**. 首次在GitHub Copilot中设置Visual Studio Code时，所需扩展会自动安装。 你无需手动下载或安装它们。 有关详细说明，请参阅 GitHub Copilot 文档中的 Visual Studio Code。

## 获取代码建议

GitHub Copilot 键入时提供编码建议。 例如，在一个 JavaScript 文件中键入此函数标头：

```javascript copy
function calculateDaysBetweenDates(begin, end) {
```

GitHub Copilot 将自动建议函数的其余部分。 要接受建议，请按 <kbd>Tab</kbd>。

你还可以在注释中使用自然语言描述你想要执行的操作，Copilot 将建议可实现你目标的代码。 例如，在一个 JavaScript 文件中键入此注释：

```javascript copy
// write a function to
// find all images without alternate text
// and give them a red border
```

GitHub Copilot 将自动建议代码。 要接受建议，请按 <kbd>Tab</kbd>。

> \[!TIP]
> 如果你从 Copilot 收到的建议很少或根本没有建议，则可能是启用了重复检测功能。 有关重复检测的详细信息，请参阅 [以个人订阅者身份管理 GitHub Copilot 策略](/zh/copilot/how-tos/manage-your-account/manage-policies#enabling-or-disabling-suggestions-matching-public-code)。

## 显示替代建议

对于任何给定的输入，GitHub Copilot 可以提供多个建议。 可以选择要使用的建议，或拒绝所有建议。

例如，在一个 JavaScript 文件中键入此函数标头，然后按 <kbd>Enter</kbd>：

```javascript copy
function calculateDaysBetweenDates(begin, end) {
```

GitHub Copilot 将向您显示一条建议。

现在，将鼠标悬停在建议上以显示 GitHub Copilot 用于选择建议的控件。 要显示下一批或上一批建议，请单击控件中的向前或向后箭头按钮。

也可以使用键盘快捷方式显示替代建议：

| OS                                        | 查看下一个建议 | 查看上一个建议 |
| :---------------------------------------- | :------ | :------ |
| macOS                                     |         |         |
| <kbd>Option (⌥) 或 Alt</kbd>+<kbd>]</kbd>  |         |         |
| <kbd>Option (⌥) 或 Alt</kbd>+<kbd>\[</kbd> |         |         |
| Windows 或 Linux                           |         |         |
| <kbd>Alt</kbd>+<kbd>]</kbd>               |         |         |
| <kbd>Alt</kbd>+<kbd>\[</kbd>              |         |         |

要接受建议，请单击 Copilot 命令面板中的“接受”，或按 <kbd>Tab</kbd>。要拒绝所有建议，请按 <kbd>Esc</kbd>。

## 在新选项卡中显示多个建议

如果不想使用 GitHub Copilot 提供的任何初始建议，可以在新选项卡中显示多个建议。

例如，在一个 JavaScript 文件中键入此函数标头，然后按 <kbd>Enter</kbd>：

```javascript copy
function calculateDaysBetweenDates(begin, end) {
```

GitHub Copilot 将向您显示一条建议。 现在，按 <kbd>Ctrl</kbd>+<kbd>Enter</kbd>，以打开具有多个其他选项的新选项卡。

要接受建议，请单击建议下方的“**接受建议编号**”。 若要拒绝所有建议，请关闭选项卡。

## 接受部分建议

如果您不想接受来自 GitHub Copilot 的整条建议，则可以接受建议中的下一个单词或下一行。

例如，在一个 JavaScript 文件中键入此函数标头，然后按 <kbd>Enter</kbd>：

```javascript copy
function calculateDaysBetweenDates(begin, end) {
```

GitHub Copilot 将自动以灰色文本显示整个函数正文。 具体的建议可能会有所不同。

现在，将鼠标悬停在建议上以显示 GitHub Copilot 用于选择建议的控件。 要只接受建议的下一个单词，请单击控件中的“接受单词”。\*\*\*\*

或者，也可以使用键盘快捷方式接受建议的下一个单词：

| OS                         | 接受下一个字词 |
| :------------------------- | :------ |
| macOS                      |         |
| <kbd>命令</kbd>+<kbd>→</kbd> |         |
| Windows 或 Linux            |         |
| <kbd>控制</kbd>+<kbd>→</kbd> |         |

如果希望接受下一行建议，则需要为命令 `editor.action.inlineSuggest.acceptNextLine` 设置自定义键盘快捷方式。 有关设置自定义键盘快捷方式的详细信息，请参阅 [在环境中配置 GitHub Copilot](/zh/copilot/how-tos/configure-personal-settings/configure-in-ide)。

## 导航与接受 next edit suggestions

Next edit suggestions 根据正在进行的更改预测可能需要的编辑位置和内容。

可以使用 <kbd>Tab</kbd> 浏览建议的代码更改，从而更轻松地找到下一个相关编辑，而无需手动搜索文件或引用。 再次按 <kbd>Tab</kbd> 可接受建议。

装订线中的箭头表示有可用的编辑建议。 将鼠标悬停在箭头上以access编辑建议菜单，该菜单提供键盘快捷方式和设置选项。 如果编辑建议在当前编辑器视图之外，则箭头将向上或向下指，以指示下一条建议的位置。

![Visual Studio Code 中的装订线菜单的屏幕截图。 箭头用深橙色突出显示。](/assets/images/help/copilot/vsc-advanced-code-completion-menu.png)

有关更多详细信息和示例，请参阅 GitHub Copilot 文档中的Visual Studio Code。

## 更改 AI 模型

可以更改用于生成内联建议的大型语言模型。 有关详细信息，请参阅“[更改适用于 GitHub Copilot 内联建议的 AI 模型](/zh/copilot/how-tos/use-ai-models/change-the-completion-model)”。

</div>

<div class="ghd-tool vimneovim">

## 简介

本指南演示如何从 GitHub Copilot Vim/Neovim 中获取编码建议。 要查看其他常用编码环境的说明，请使用页面顶部的工具切换器。

## Prerequisites

* **Copilot访问** 。 若要在 Vim/Neovim 中使用 GitHub Copilot ，需要通过 Copilot Free 或付费 Copilot 计划进行有限访问才能完全访问。 请参阅“[什么是GitHub Copilot？](/zh/copilot/get-started/what-is-github-copilot#get-access)”。

* **Vim/Neovim 的兼容版本**。 若要在 Vim/Neovim 中使用 GitHub Copilot ，必须安装 Vim 版本 9.0.0185/Neovim 0.6 或更高版本，并安装 Node.js 18 或更高版本。 有关详细信息，请参阅 [Vim](https://vimhelp.org/) / [Neovim 文档](https://neovim.io/doc/)和 [Node.js 网站](https://nodejs.org/en/)。

* **GitHub Copilot Vim/Neovim 的扩展**。 若要在 Vim/Neovim 中使用 GitHub Copilot ，必须安装 GitHub Copilot 插件。 有关详细信息，请参阅“[在环境中安装 GitHub Copilot 扩展](/zh/copilot/how-tos/set-up/install-copilot-extension)”。

## 了解如何在 Vim/Neovim 中使用GitHub Copilot

当你在 Vim/Neovim 中键入时，GitHub Copilot 可提供内联建议。 要接受建议，请按 <kbd>Tab</kbd> 键。

有关在 Vim/Neovim 中使用 GitHub Copilot 的详细信息和指南，请运行以下命令以查看插件文档：

```shell copy
:help copilot
```

</div>

<div class="ghd-tool azure_data_studio">

## 简介

本指南演示如何从GitHub CopilotAzure Data Studio中获取编码建议。 要查看其他常用编码环境的说明，请使用页面顶部的工具切换器。

## Prerequisites

* **Copilot访问** 。 若要在Azure Data Studio中使用GitHub Copilot，需要通过Copilot Free受限访问权限或付费Copilot计划进行完全访问。 请参阅“[什么是GitHub Copilot？](/zh/copilot/get-started/what-is-github-copilot#get-access)”。

* **兼容版本的 Azure Data Studio**。 若要在Azure Data Studio中使用GitHub Copilot，必须安装 Azure Data Studio 1.44.0 或更高版本。 有关详细信息，请参阅 Azure Data Studio 文档中的 [Azure Data Studio 下载页](https://docs.microsoft.com/sql/azure-data-studio/download-azure-data-studio)。

* **GitHub Copilot Azure Data Studio的扩展**。 若要在Azure Data Studio中使用GitHub Copilot，必须安装GitHub Copilot扩展。 有关详细信息，请参阅“[在环境中安装 GitHub Copilot 扩展](/zh/copilot/how-tos/set-up/install-copilot-extension)”。

## 获取代码建议

当你在 Azure Data Studio 中创建 SQL 数据库时，GitHub Copilot 可以为你提供内联建议。 例如，如果要编写联接两个表的查询， Copilot 则可能会从打开的编辑器中的列、工作区中的其他文件以及常见语法模式建议联接条件。

在一个 SQL 文件中，键入如下查询：

```sql copy
SELECT [UserId], [Red], [Orange], [Yellow], [Green], [Blue], [Purple], [Rainbow]
FROM [Tag].[Scoreboard]
INNER JOIN
```

GitHub Copilot 将自动以灰色文本显示建议的联接条件。 具体的建议可能会有所不同。 要接受建议，请按 <kbd>Tab</kbd>。

你还可以在注释中使用自然语言描述你想要执行的操作，Copilot 将建议可实现你目标的代码。 例如，在一个 SQL 文件中键入此注释：

```sql copy
SELECT TokenColor, COUNT(UserID) AS UserCount
FROM Tag.Users
GROUP BY TokenColor
-- pivot that query on tokencolor for Purple, Blue, Green, Yellow, Orange, Red
-- and rename the columns to match the colors
SELECT [Purple], [Blue], [Green], [Yellow], [Orange], [Red]
```

GitHub Copilot 将自动建议代码。 要接受建议，请按 <kbd>Tab</kbd>。

> \[!TIP]
> 如果你从 Copilot 收到的建议很少或根本没有建议，则可能是启用了重复检测功能。 有关重复检测的详细信息，请参阅 [以个人订阅者身份管理 GitHub Copilot 策略](/zh/copilot/how-tos/manage-your-account/manage-policies#enabling-or-disabling-suggestions-matching-public-code)。

## 显示替代建议

对于某些建议， GitHub Copilot 可以提供多个替代方法。 可以选择要采用的建议，或拒绝所有建议。

例如，在一个 SQL 文件中键入此查询：

```sql copy
SELECT [UserId], [Red], [Orange], [Yellow], [Green], [Blue], [Purple], [Rainbow]
FROM [Tag].[Scoreboard]
INNER JOIN
```

GitHub Copilot 将向您显示一条建议。

现在，将鼠标悬停在建议上以显示 GitHub Copilot 用于选择建议的控件。 要显示下一批或上一批建议，请单击控件中的向前或向后箭头按钮。

也可以使用键盘快捷方式显示替代建议：

| OS                           | 查看下一个建议 | 查看上一个建议 |
| :--------------------------- | :------ | :------ |
| macOS                        |         |         |
| <kbd>选择</kbd>+<kbd>\[</kbd>  |         |         |
| <kbd>选择</kbd>+<kbd>]</kbd>   |         |         |
| Windows 或 Linux              |         |         |
| <kbd>Alt</kbd>+<kbd>\[</kbd> |         |         |
| <kbd>Alt</kbd>+<kbd>]</kbd>  |         |         |

若要接受建议，请单击控件中的 Copilot “接受”，或按 <kbd>Tab</kbd>。若要拒绝所有建议，请按 <kbd>Esc</kbd>。

## 接受部分建议

如果您不想接受来自 GitHub Copilot 的整条建议，则可以接受建议中的下一个单词或下一行。

例如，在一个 SQL 文件中键入此查询：

```sql copy
SELECT [UserId], [Red], [Orange], [Yellow], [Green], [Blue], [Purple], [Rainbow]
FROM [Tag].[Scoreboard]
INNER JOIN
```

GitHub Copilot 将以灰色文本显示建议。 具体的建议可能会有所不同。

现在，将鼠标悬停在建议上以显示 GitHub Copilot 用于选择建议的控件。 要只接受建议的下一个单词，请单击控件中的“接受单词”。\*\*\*\*

或者，也可以使用键盘快捷方式接受建议的下一个单词：

| OS                         | 接受下一个字词 |
| :------------------------- | :------ |
| macOS                      |         |
| <kbd>命令</kbd>+<kbd>→</kbd> |         |
| Windows 或 Linux            |         |
| <kbd>控制</kbd>+<kbd>→</kbd> |         |

如果要接受下一行建议，则需要为命令 `editor.action.inlineSuggest.acceptNextLine` 设置自定义键盘快捷键。 有关设置自定义键盘快捷方式的详细信息，请参阅 Microsoft 文档中 Azure Data Studio 中的 [Keyboard 快捷方式](https://learn.microsoft.com/en-us/azure-data-studio/keyboard-shortcuts)。

</div>

<div class="ghd-tool xcode">

## 简介

本指南演示如何从 GitHub Copilot Xcode 中获取编码建议。 要查看其他常用编码环境的说明，请使用页面顶部的工具切换器。

## Prerequisites

* **Copilot访问** 。 要在 Xcode 中使用 GitHub Copilot，你需要通过 Copilot Free 获得有限访问权限，或订阅付费的 Copilot 计划以获得完全访问权限。 请参阅“[什么是GitHub Copilot？](/zh/copilot/get-started/what-is-github-copilot#get-access)”。

* **GitHub Copilot Xcode 的扩展**。 要在 Xcode 中使用 GitHub Copilot，必须安装适用于 Xcode 的 GitHub Copilot 扩展。 请参阅 [在环境中安装 GitHub Copilot 扩展](/zh/copilot/how-tos/set-up/install-copilot-extension)。

## 获取代码建议

GitHub Copilot 键入时提供编码建议。 例如，在 Swift 文件中键入此函数签名：

```swift copy
func calculateDaysBetweenDates(
```

GitHub Copilot 将自动以灰色文本显示整个函数正文。 若要接受建议的第一行，请按 <kbd>Tab</kbd>。若要查看完整建议，请按住 <kbd>Option</kbd>，若要接受完整建议，请按 <kbd>Option</kbd>+<kbd>Tab</kbd>。

### 改进代码建议

如果遇到代码建议方面的问题（例如建议冲突或缺失），则可以尝试以下操作：

* **禁用 Xcode 的原生预测文本完成：** 为避免收到两组代码建议，可以禁用 Xcode 的原生预测文本完成。 可以在 Xcode 设置中的“文本编辑”下的“编辑”选项卡中找到此设置。
* **检查 Copilot 中是否启用了重复内容检测：** 如果您从 Copilot 收到的建议很少或没有任何建议，则可能启用了重复内容检测。 有关重复检测的详细信息，请参阅 [以个人订阅者身份管理 GitHub Copilot 策略](/zh/copilot/how-tos/manage-your-account/manage-policies#enabling-or-disabling-suggestions-matching-public-code)。
* **检查更新并重启 Xcode：** 确保扩展应用程序中有最新版本的 Copilot Xcode 并重启 Xcode。

你也可以在适用于 Xcode 的 [Copilot 存储库](https://github.com/github/CopilotForXcode)中提交议题。

## 导航与接受 next edit suggestions

Next edit suggestions 根据正在进行的更改预测可能需要的编辑位置和内容。

可以使用 <kbd>Tab</kbd> 浏览建议的代码更改，从而更轻松地找到下一个相关编辑，而无需手动搜索文件或引用。 再次按 <kbd>Tab</kbd> 接受建议（除非已禁用 Xcode 扩展的 GitHub Copilot “接受带有 Tab 的建议”设置）。

装订线中的箭头表示有可用的编辑建议。 将鼠标悬停在箭头上以access编辑建议菜单，该菜单提供键盘快捷方式和设置选项。

![Xcode 中边栏菜单的屏幕截图。 箭头用深橙色突出显示。](/assets/images/help/copilot/xcode-advanced-code-completion-menu.png)

</div>

<div class="ghd-tool eclipse">

## 简介

本指南演示如何从 GitHub Copilot Eclipse 中获取编码建议。 要查看其他常用编码环境的说明，请使用页面顶部的工具切换器。

## Prerequisites

* **Copilot访问** 。 若要在 Eclipse 中使用 GitHub Copilot ，需要通过 Copilot Free 有限访问权限或付费 Copilot 计划进行完全访问。 请参阅“[什么是GitHub Copilot？](/zh/copilot/get-started/what-is-github-copilot#get-access)”。

* **GitHub Copilot Eclipse 的扩展**。 若要在 Eclipse 中使用 GitHub Copilot ，必须安装 GitHub Copilot 扩展。 请参阅 [在环境中安装 GitHub Copilot 扩展](/zh/copilot/how-tos/set-up/install-copilot-extension?tool=eclipse)。

## 获取代码建议

GitHub Copilot 键入时提供编码建议。 例如，在 Java 文件中键入此函数标头：

```java copy
public int getDiff(int a, int b)
```

GitHub Copilot 将自动建议函数的其余部分。 要接受建议，请按 <kbd>Tab</kbd>。
若要放弃建议，请按 <kbd>Esc</kbd>。

你还可以在注释中使用自然语言描述你想要执行的操作，Copilot 将建议可实现你目标的代码。 例如，在一个 Java 文件中键入此注释：

```java copy
/*
 * Return the difference between two different integers.
 */
```

GitHub Copilot 将自动建议代码。

> \[!TIP]
> 如果你从 Copilot 收到的建议很少或根本没有建议，则可能是启用了重复检测功能。 有关重复检测的详细信息，请参阅 [以个人订阅者身份管理 GitHub Copilot 策略](/zh/copilot/how-tos/manage-your-account/manage-policies#enabling-or-disabling-suggestions-matching-public-code)。

## 手动触发内嵌建议

您还可以使用键盘快捷键触发内联建议。

| OS                                          | 触发内联建议 |
| :------------------------------------------ | :----- |
| macOS                                       |        |
| <kbd>选择</kbd>+<kbd>命令</kbd>+<kbd>/</kbd>    |        |
| Windows 或 Linux                             |        |
| <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>/</kbd> |        |

## 接受部分建议

如果您不想接受来自 Copilot 的整个建议，也可以只接受建议中的下一个词。

| OS                           | 接受下一个字词 |
| :--------------------------- | :------ |
| macOS                        |         |
| <kbd>命令</kbd>+<kbd>→</kbd>   |         |
| Windows 或 Linux              |         |
| <kbd>Ctrl</kbd>+<kbd>→</kbd> |         |

## 导航与接受 next edit suggestions

Next edit suggestions 根据正在进行的更改预测可能需要的编辑位置和内容。

可以使用 <kbd>Tab</kbd> 浏览建议的代码更改，从而更轻松地找到下一个相关编辑，而无需手动搜索文件或引用。 再次按 <kbd>Tab</kbd> 可接受建议。

装订线中的箭头表示有可用的编辑建议。 将鼠标悬停在箭头上以access编辑建议菜单，该菜单提供键盘快捷方式和设置选项。

![Eclipse 中装订线菜单的屏幕截图。 箭头用深橙色突出显示。](/assets/images/help/copilot/eclipse-advanced-code-completion-menu.png)

</div>

## 后续步骤

* **学习如何编写有效的提示** - 查看 [GitHub Copilot 对话助手的提示设计](/zh/copilot/concepts/prompting/prompt-engineering)。
* **在编辑器中配置 Copilot** - 可以在编辑器中启用或禁用GitHub Copilot，并为其创建自己的首选键盘快捷方式Copilot。 请参阅 [在环境中配置 GitHub Copilot](/zh/copilot/how-tos/configure-personal-settings/configure-in-ide)。
* **开始使用 GitHub Copilot Chat** - 了解如何使用 Copilot 向 GitHub Copilot Chat 询问信息并获取帮助。 请参阅 [在 IDE 中向 GitHub Copilot 提问问题](/zh/copilot/how-tos/chat-with-copilot/chat-in-ide)。
* **排查问题** - 进一步了解如何使用 GitHub Copilot 排查常见问题。 请参阅 [对 GitHub Copilot 进行故障排除](/zh/copilot/how-tos/troubleshoot-copilot)。

## 其他阅读材料

* [IDE 中的 GitHub Copilot 代码建议](/zh/copilot/concepts/completions/code-suggestions)