关于 GitHub Copilot 和 JetBrains IDE
本指南演示了如何在 JetBrains IDE 中获取来自 GitHub Copilot 的代码建议。要查看其他流行编码环境的说明,请使用页面顶部的工具切换器。
本指南中的示例使用 Java,但其他语言的工作方式类似。GitHub Copilot 为多种语言和各种框架提供建议,但对 Python、JavaScript、TypeScript、Ruby、Go、C# 和 C++ 的效果尤其好。GitHub Copilot 还可以帮助生成数据库查询、生成 API 和框架建议,并可以帮助进行基础设施即代码开发。
先决条件
-
Copilot 订阅。要在 JetBrains 中使用 GitHub Copilot,您必须拥有有效的 GitHub Copilot 订阅。有关如何获取 Copilot 访问权限的信息,请参阅“什么是 GitHub Copilot?”。
-
兼容的 JetBrains IDE。要在 JetBrains 中使用 GitHub Copilot,您必须安装兼容的 JetBrains IDE。GitHub Copilot 与以下 IDE 兼容
- IntelliJ IDEA(Ultimate、Community、Educational)
- Android Studio
- AppCode
- CLion
- Code With Me Guest
- DataGrip
- DataSpell
- GoLand
- JetBrains Client
- MPS
- PhpStorm
- PyCharm(Professional、Community、Educational)
- Rider
- RubyMine
- RustRover
- WebStorm
- Writerside
请参阅 JetBrains IDE 工具查找器以进行下载。
-
GitHub Copilot 插件。请参阅 JetBrains Marketplace 中的 GitHub Copilot 插件。有关安装说明,请参阅“在你的环境中安装 GitHub Copilot 扩展”。
-
在你的 JetBrains IDE 中登录 GitHub。有关身份验证说明,请参阅“在你的环境中安装 GitHub Copilot 扩展”。
获取代码建议
GitHub Copilot 在你键入时提供代码建议。例如,在 Java 文件中,通过键入 class Test
创建一个类。
GitHub Copilot 将自动以灰色文本建议类体。要接受建议,请按 Tab。
你也可以在注释中使用自然语言描述你想要执行的操作,Copilot 将建议实现你的目标的代码。例如,在 Java 文件中键入以下注释
// find all images without alternate text // and give them a red border void process () {
// find all images without alternate text
// and give them a red border
void process () {
GitHub Copilot 将自动建议代码。要接受建议,请按 Tab。
GitHub Copilot 将尝试匹配你的代码的上下文和风格。你可以随时编辑建议的代码。
提示
如果你从 Copilot 收到的建议有限或没有建议,则可能是启用了重复检测。有关重复检测的更多信息,请参阅“管理 Copilot 策略作为个人订阅者”。
显示替代建议
对于任何给定的输入,GitHub Copilot 可能会提供多个建议。你可以选择要使用的建议,或拒绝所有建议。
例如,在 Java 文件中键入以下行,然后按 Enter
private int calculateDaysBetweenDates(Date date1,
private int calculateDaysBetweenDates(Date date1,
GitHub Copilot 将向你显示一个建议。
现在将鼠标悬停在建议上以显示用于选择建议的 GitHub Copilot 控件。要显示下一个或上一个建议,请单击控件中的前进或后退箭头按钮。
你还可以使用键盘快捷键来显示替代建议
操作系统 | 查看下一个建议 | 查看上一个建议 |
---|---|---|
macOS | Option+] | Option+[ |
Windows 或 Linux | Alt+] | Alt+[ |
要接受建议,请单击 Copilot 命令面板中的“接受”,或按 Tab。要拒绝所有建议,请按 Esc。
在新标签页中显示多个建议
如果你不想使用 GitHub Copilot 提供的任何初始建议,则可以在新标签页中显示多个建议。
例如,在 Java 文件中键入以下行
private int calculateDaysBetweenDates(Date date1,
private int calculateDaysBetweenDates(Date date1,
GitHub Copilot 将向你显示一个建议。
要打开一个包含多个其他建议的新标签页,请使用以下键盘快捷键,然后单击**打开 GitHub Copilot**
操作系统 | 打开多个建议 |
---|---|
macOS | Command+Shift+A |
Windows 或 Linux | Ctrl+Enter |
要接受建议,请在建议下方单击**接受建议 NUMBER**。要拒绝所有建议,请关闭标签页。
接受部分建议
如果你不想接受来自 GitHub Copilot 的整个建议,则可以接受建议的下一个单词或下一行。
例如,在 Java 文件中键入以下行
private int calculateDaysBetweenDates(Date date1,
private int calculateDaysBetweenDates(Date date1,
GitHub Copilot 将以灰色文本显示建议。确切的建议可能会有所不同。
现在将鼠标悬停在建议上以显示用于选择建议的 GitHub Copilot 控件。要仅接受建议的下一个单词,请单击控件中的**接受单词**。
或者,你可以使用键盘快捷键来接受建议的下一个单词
操作系统 | 接受下一个单词 | 接受下一行 |
---|---|---|
macOS | Command+→ | Command+Control+→ |
Windows 或 Linux | Control+→ | Control+Alt+→ |
如果你想接受建议的下一行,则需要为命令 editor.action.inlineSuggest.acceptNextLine
设置自定义键盘快捷键。有关设置自定义键盘快捷键的更多信息,请参阅“在你的环境中配置 GitHub Copilot”。
关于 GitHub Copilot 和 Visual Studio
本指南演示了如何在 Windows 的 Visual Studio 中获取来自 GitHub Copilot 的代码建议。要查看其他流行编码环境的说明,请使用页面顶部的工具切换器。
本指南中的示例使用 C#,但其他语言的工作方式类似。GitHub Copilot 为多种语言和各种框架提供建议,但对 Python、JavaScript、TypeScript、Ruby、Go、C# 和 C++ 的效果尤其好。GitHub Copilot 还可以帮助生成数据库查询、生成 API 和框架建议,并可以帮助进行基础设施即代码开发。
先决条件
-
Copilot 订阅。要在 Visual Studio 中使用 GitHub Copilot,您必须拥有有效的 GitHub Copilot 订阅。有关如何获取 Copilot 访问权限的信息,请参阅“什么是 GitHub Copilot?”。
-
Visual Studio 的兼容版本。要在 Visual Studio 中使用 GitHub Copilot,您必须安装 Windows 版 Visual Studio 2022 17.8 或更高版本。有关更多信息,请参阅 Microsoft 文档中的“安装 Visual Studio”。
-
Visual Studio 的 GitHub Copilot 扩展。有关如何安装 Copilot 扩展的说明,请参阅 Microsoft 文档中的“在 Visual Studio 中安装 GitHub Copilot”。
-
将您的 GitHub 帐户添加到 Visual Studio。请参阅 Microsoft 文档中的将您的 GitHub 帐户添加到 Visual Studio 密钥链。
获取代码建议
GitHub Copilot 在您键入时提供代码建议。例如,在 C# 文件中键入以下函数签名
int CalculateDaysBetweenDates(
int CalculateDaysBetweenDates(
GitHub Copilot 将自动以灰色文本建议整个函数体。要接受建议,请按 Tab 键。
您还可以使用自然语言在注释中描述您想要执行的操作,Copilot 将建议实现您目标的代码。例如,在 C# 文件中键入以下注释
using System.Xml.Linq; var doc = XDocument.Load("index.xhml"); // find all images
using System.Xml.Linq;
var doc = XDocument.Load("index.xhml");
// find all images
GitHub Copilot 将建议函数的实现。要接受建议,请按 Tab 键。
提示
如果你从 Copilot 收到的建议有限或没有建议,则可能是启用了重复检测。有关重复检测的更多信息,请参阅“管理 Copilot 策略作为个人订阅者”。
显示替代建议
对于任何给定的输入,GitHub Copilot 可能会提供多个建议。你可以选择要使用的建议,或拒绝所有建议。
例如,在 C# 文件中键入以下函数签名
int CalculateDaysBetweenDates(
int CalculateDaysBetweenDates(
GitHub Copilot 将向你显示一个建议。
现在将鼠标悬停在建议上以显示用于选择建议的 GitHub Copilot 控件。要显示下一个或上一个建议,请单击控件中的前进或后退箭头按钮。
或者,您可以通过按键盘上的 Alt+.(或 Alt+,)来显示其他建议。
要接受建议,请单击 Copilot 命令面板中的“接受”,或按 Tab。要拒绝所有建议,请按 Esc。
关于 GitHub Copilot 和 Visual Studio Code
本指南演示如何在 Visual Studio Code 中获取 GitHub Copilot 的代码建议。要查看其他常用编码环境的说明,请使用页面顶部的工具切换器。
本指南中的示例使用 JavaScript,但其他语言的工作方式类似。GitHub Copilot 为多种语言和各种框架提供建议,但对 Python、JavaScript、TypeScript、Ruby、Go、C# 和 C++ 尤其有效。GitHub Copilot 还可以帮助生成数据库查询、生成 API 和框架建议,并可以帮助进行基础设施即代码开发。
先决条件
-
Copilot 订阅。要在 Visual Studio Code 中使用 GitHub Copilot,您必须拥有有效的 GitHub Copilot 订阅。有关如何访问 Copilot 的信息,请参阅“什么是 GitHub Copilot?”。
-
Visual Studio Code。要在 Visual Studio Code 中使用 GitHub Copilot,您必须安装 Visual Studio Code。有关更多信息,请参阅 Visual Studio Code 下载页面。
-
Visual Studio Code 的 Copilot 扩展。要在 Visual Studio Code 中使用 GitHub Copilot,您必须安装 GitHub Copilot 扩展。有关更多信息,请参阅 Visual Studio Code 文档中的“在 Visual Studio Code 中设置 GitHub Copilot”。
获取代码建议
GitHub Copilot 在您键入时提供代码建议。例如,在 JavaScript 文件中键入以下函数头
function calculateDaysBetweenDates(begin, end) {
function calculateDaysBetweenDates(begin, end) {
GitHub Copilot 将自动建议函数的其余部分。要接受建议,请按 Tab 键。
您还可以使用自然语言在注释中描述您想要执行的操作,Copilot 将建议实现您目标的代码。例如,在 JavaScript 文件中键入以下注释
// write a function to // find all images without alternate text // and give them a red border
// write a function to
// find all images without alternate text
// and give them a red border
GitHub Copilot 将自动建议代码。要接受建议,请按 Tab。
提示
如果你从 Copilot 收到的建议有限或没有建议,则可能是启用了重复检测。有关重复检测的更多信息,请参阅“管理 Copilot 策略作为个人订阅者”。
显示替代建议
对于任何给定的输入,GitHub Copilot 可能会提供多个建议。你可以选择要使用的建议,或拒绝所有建议。
例如,在 JavaScript 文件中键入以下函数头,然后按 Enter 键
function calculateDaysBetweenDates(begin, end) {
function calculateDaysBetweenDates(begin, end) {
GitHub Copilot 将向你显示一个建议。
现在将鼠标悬停在建议上以显示用于选择建议的 GitHub Copilot 控件。要显示下一个或上一个建议,请单击控件中的前进或后退箭头按钮。
你还可以使用键盘快捷键来显示替代建议
操作系统 | 查看下一个建议 | 查看上一个建议 |
---|---|---|
macOS | Option (⌥) 或 Alt+] | Option (⌥) 或 Alt+[ |
Windows 或 Linux | Alt+] | Alt+[ |
要接受建议,请单击 Copilot 命令面板中的“接受”,或按 Tab。要拒绝所有建议,请按 Esc。
在新标签页中显示多个建议
如果你不想使用 GitHub Copilot 提供的任何初始建议,则可以在新标签页中显示多个建议。
例如,在 JavaScript 文件中键入以下函数头,然后按 Enter 键
function calculateDaysBetweenDates(begin, end) {
function calculateDaysBetweenDates(begin, end) {
GitHub Copilot 将向您显示一个建议。现在,按 Ctrl+Enter 以在新选项卡中打开多个其他选项。
要接受建议,请在建议下方单击**接受建议 NUMBER**。要拒绝所有建议,请关闭标签页。
接受部分建议
如果你不想接受来自 GitHub Copilot 的整个建议,则可以接受建议的下一个单词或下一行。
例如,在 JavaScript 文件中键入以下函数头,然后按 Enter 键
function calculateDaysBetweenDates(begin, end) {
function calculateDaysBetweenDates(begin, end) {
GitHub Copilot 将自动以灰色文本建议整个函数体。确切的建议可能会有所不同。
现在将鼠标悬停在建议上以显示用于选择建议的 GitHub Copilot 控件。要仅接受建议的下一个单词,请单击控件中的**接受单词**。
或者,你可以使用键盘快捷键来接受建议的下一个单词
操作系统 | 接受下一个单词 |
---|---|
macOS | Command+→ |
Windows 或 Linux | Control+→ |
如果你想接受建议的下一行,则需要为命令 editor.action.inlineSuggest.acceptNextLine
设置自定义键盘快捷键。有关设置自定义键盘快捷键的更多信息,请参阅“在你的环境中配置 GitHub Copilot”。
关于 GitHub Copilot 和 Vim/Neovim
本指南演示如何在 Vim/Neovim 中获取 GitHub Copilot 的代码建议。要查看其他常用编码环境的说明,请使用页面顶部的工具切换器。
先决条件
-
Copilot 订阅。要在 Vim/Neovim 中使用 GitHub Copilot,您必须拥有有效的 GitHub Copilot 订阅。有关如何访问 Copilot 的信息,请参阅“什么是 GitHub Copilot?”。
-
Vim/Neovim 的兼容版本。要在 Vim/Neovim 中使用 GitHub Copilot,您必须安装 Vim 9.0.0185/Neovim 0.6 或更高版本以及 Node.js 18 或更高版本。有关更多信息,请参阅 Vim/Neovim 文档 和 Node.js 网站。
-
Vim/Neovim 的 GitHub Copilot 扩展。要在 Vim/Neovim 中使用 GitHub Copilot,您必须安装 GitHub Copilot 插件。有关更多信息,请参阅“在您的环境中安装 GitHub Copilot 扩展”。
学习在 Vim/Neovim 中使用 GitHub Copilot
GitHub Copilot 在您在 Vim/Neovim 中键入时提供内联建议。要接受建议,请按 tab 键。
有关在 Vim/Neovim 中使用 GitHub Copilot 的更多信息和指南,请运行以下命令以查看插件文档
:help copilot
:help copilot
关于 GitHub Copilot 和 Azure Data Studio
本指南演示如何在 Azure Data Studio 中获取 GitHub Copilot 的代码建议。要查看其他常用编码环境的说明,请使用页面顶部的工具切换器。
先决条件
-
Copilot 订阅。要在 Azure Data Studio 中使用 GitHub Copilot,您必须拥有有效的 GitHub Copilot 订阅。有关如何访问 Copilot 的信息,请参阅“什么是 GitHub Copilot?”。
-
Azure Data Studio 的兼容版本。要在 Azure Data Studio 中使用 GitHub Copilot,您必须安装 Azure Data Studio 1.44.0 或更高版本。有关更多信息,请参阅 Azure Data Studio 文档中的 Azure Data Studio 下载页面。
-
Azure Data Studio 的 GitHub Copilot 扩展。要在 Azure Data Studio 中使用 GitHub Copilot,您必须安装 GitHub Copilot 扩展。有关更多信息,请参阅“在您的环境中安装 GitHub Copilot 扩展”。
获取代码建议
当您在 Azure Data Studio 中创建 SQL 数据库时,GitHub Copilot 可以为您提供内联建议。例如,如果您正在编写连接两个表的查询,Copilot 可能会根据打开的编辑器中的列、工作区中的其他文件以及常见的语法模式建议连接条件。
在 SQL 文件中,键入以下查询
SELECT [UserId], [Red], [Orange], [Yellow], [Green], [Blue], [Purple], [Rainbow] FROM [Tag].[Scoreboard] INNER JOIN
SELECT [UserId], [Red], [Orange], [Yellow], [Green], [Blue], [Purple], [Rainbow]
FROM [Tag].[Scoreboard]
INNER JOIN
GitHub Copilot 将自动以灰色文本建议连接条件。确切的建议可能会有所不同。要接受建议,请按 Tab 键。
您还可以使用自然语言在注释中描述您想要执行的操作,Copilot 将建议实现您目标的代码。例如,在 SQL 文件中键入以下注释
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]
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 将自动建议代码。要接受建议,请按 Tab。
提示
如果您收到的 Copilot 建议有限或没有,则可能是启用了重复检测。有关重复检测的更多信息,请参阅“管理 Copilot 策略作为个人订阅者”。
显示替代建议
对于某些建议,GitHub Copilot 可能会提供多个备选方案。您可以选择要使用的建议,或拒绝所有建议。
例如,在 SQL 文件中键入以下查询
SELECT [UserId], [Red], [Orange], [Yellow], [Green], [Blue], [Purple], [Rainbow] FROM [Tag].[Scoreboard] INNER JOIN
SELECT [UserId], [Red], [Orange], [Yellow], [Green], [Blue], [Purple], [Rainbow]
FROM [Tag].[Scoreboard]
INNER JOIN
GitHub Copilot 将向你显示一个建议。
现在将鼠标悬停在建议上以显示用于选择建议的 GitHub Copilot 控件。要显示下一个或上一个建议,请单击控件中的前进或后退箭头按钮。
你还可以使用键盘快捷键来显示替代建议
操作系统 | 查看下一个建议 | 查看上一个建议 |
---|---|---|
macOS | Option+[ | Option+] |
Windows 或 Linux | Alt+[ | Alt+] |
要接受建议,请单击 Copilot 控件中的“接受”,或按 Tab 键。要拒绝所有建议,请按 Esc 键。
接受部分建议
如果你不想接受来自 GitHub Copilot 的整个建议,则可以接受建议的下一个单词或下一行。
例如,在 SQL 文件中键入以下查询
SELECT [UserId], [Red], [Orange], [Yellow], [Green], [Blue], [Purple], [Rainbow] FROM [Tag].[Scoreboard] INNER JOIN
SELECT [UserId], [Red], [Orange], [Yellow], [Green], [Blue], [Purple], [Rainbow]
FROM [Tag].[Scoreboard]
INNER JOIN
GitHub Copilot 将以灰色文本向您显示一个建议。确切的建议可能会有所不同。
现在将鼠标悬停在建议上以显示用于选择建议的 GitHub Copilot 控件。要仅接受建议的下一个单词,请单击控件中的**接受单词**。
或者,你可以使用键盘快捷键来接受建议的下一个单词
操作系统 | 接受下一个单词 |
---|---|
macOS | Command+→ |
Windows 或 Linux | Control+→ |
如果您想接受建议的下一行,则需要为命令 editor.action.inlineSuggest.acceptNextLine
设置自定义键盘快捷键。有关设置自定义键盘快捷键的更多信息,请参阅 Microsoft 文档中的“Azure Data Studio 中的键盘快捷键”。
注意
Xcode 的 GitHub Copilot 扩展处于公开预览阶段,可能会发生更改。
关于 GitHub Copilot for Xcode
本指南演示如何在 Xcode 中获取 GitHub Copilot 的代码建议。要查看其他常用编码环境的说明,请使用页面顶部的工具切换器。
先决条件
-
Copilot 订阅。要在 Xcode 中使用 GitHub Copilot,您必须拥有有效的 GitHub Copilot 订阅。有关如何访问 Copilot 的信息,请参阅“什么是 GitHub Copilot?”。
-
Xcode 和 macOS 的兼容版本。要在 Xcode 中使用 GitHub Copilot,您必须安装 Xcode 8.0 或更高版本以及 macOS Monterey (12.0) 或更高版本。请参阅 Apple 开发者网站上的 Xcode。
-
Xcode 的 GitHub Copilot 扩展。要在 Xcode 中使用 GitHub Copilot,您必须安装 Xcode 的 GitHub Copilot 扩展。请参阅“在您的环境中安装 GitHub Copilot 扩展”。
获取代码建议
GitHub Copilot 在您键入时提供代码建议。例如,在 Swift 文件中键入以下函数签名
func CalculateDaysBetweenDates(
func CalculateDaysBetweenDates(
GitHub Copilot 将自动以灰色文本建议整个函数体。要接受建议的第一行,请按 Tab 键。要查看完整建议,请按住 Option 键,要接受完整建议,请按 Option+Tab 键。
改进代码建议
如果您遇到代码建议问题,例如冲突或缺少建议,您可以尝试以下操作
- 禁用 Xcode 的原生预测文本补全:为了避免收到两套代码建议,您可以禁用 Xcode 的原生预测文本补全。您可以在 Xcode 设置中的“编辑”选项卡下的“文本编辑”中找到此设置。
- 检查 Copilot 中的重复检测:如果您从 Copilot 收到的建议有限或没有建议,则可能是启用了重复检测。有关重复检测的更多信息,请参阅“个人订阅者管理 Copilot 策略”。
- 检查更新并重新启动 Xcode:确保您在扩展应用程序中拥有最新版本的 Copilot for Xcode,然后重新启动 Xcode。
您也可以在 Copilot for Xcode 代码库 中打开一个问题。
后续步骤
- 学习如何编写有效的提示 - 请参阅“GitHub Copilot 的提示工程”。
- 在您的编辑器中配置 Copilot - 您可以在编辑器中启用或禁用 GitHub Copilot,并为 Copilot 创建您自己的首选键盘快捷键。请参阅“在您的环境中配置 GitHub Copilot”。
- 开始使用 GitHub Copilot Chat - 了解如何使用 GitHub Copilot Chat 向 Copilot 询问信息和寻求帮助。请参阅“在您的 IDE 中向 GitHub Copilot 提问”。
- 排查问题 - 了解如何排查 GitHub Copilot 的常见问题。请参阅“GitHub Copilot 故障排除”。