本文档介绍了如何使用 Gemini Code Assist（IDE 中的依托 AI 技术的协作工具）帮助您在 VS Code 或 IntelliJ 以及其他受支持的 JetBrains IDE 中执行以下操作：
- 提供指导，帮助您解决代码问题。
- 为您的项目生成代码。
- 在编码时接收内嵌建议。
了解 Google Cloud 专用 Gemini Google Cloud 如何以及何时使用您的数据。
为帮助您遵守代码的所有许可要求，当 Gemini Code Assist 的建议直接引用特定来源的长篇内容时，它会提供来源引用。如需详细了解 Gemini 会注明信息来源的情况和方式，请参阅 Gemini 如何帮助您生成代码并注明信息来源。
借助代码自定义功能，您可以直接从 Gemini Code Assist 获取基于贵组织私有代码库的代码建议。了解如何配置代码自定义。
本文档面向各种技能水平的开发者。本教程假定您对 VS Code 或 IntelliJ 以及其他受支持的 JetBrains IDE 有一定的了解，并且熟悉 Google Cloud。您也可以在 Cloud Shell Editor 和 Cloud Workstations 中探索 Gemini Code Assist。
准备工作
VS Code
- 在代码文件中测试 Gemini Code Assist 功能之前，请确保文件的编码语言受支持。如需详细了解支持的编码语言，请参阅支持的编码语言。
- 如果您希望在代理后面使用 IDE，请参阅 Visual Studio Code 中的网络连接。
IntelliJ
安装 Gemini Code Assist 插件
如需在 IDE 中安装 Gemini Code Assist 插件，请按以下步骤操作：
VS Code
如需在 VS Code 中打开扩展程序视图，请点击
Extensions 或按 Ctrl/Cmd+Shift+X。搜索
Gemini Code Assist。点击安装。
如果出现提示，请重启 VS Code。
扩展程序成功安装后，Gemini Code Assist 会显示在活动栏中，供您随时使用。您可以使用顶层应用任务栏指定偏好设置来进一步配置安装的 Gemini Code Assist：依次前往 Code > Settings > Settings > Extensions，然后搜索
Gemini Code Assist。
IntelliJ
- 依次点击 settings IDE 和项目设置 > 插件。
- 在 Marketplace 标签页中，搜索
Gemini Code Assist。 - 点击 Install 以安装该插件。
- 安装完成后，点击 Restart IDE。
IDE 重启后，Gemini Code Assist 会显示在 activity 栏中。
现在，您可以在 IDE 中使用 Gemini Code Assist 了。
登录 Google 并选择 Google Cloud 项目
在此部分中，您需要登录自己的 Google 账号。如果这是您首次在 IDE 中使用 Gemini Code Assist，请选择一个Google Cloud 项目。
VS Code
如果您选择的 Google Cloud 项目未启用 Gemini for Google Cloud API，您会收到一条通知，其中包含从 IDE 启用该 API 的选项。在通知窗口中选择启用 API，为您的项目启用 API。如需了解详情，请参阅为项目设置 Gemini Code Assist。
如果您想直接在 IDE 中按照使用 Gemini Code Assist 进行编码演示文稿中的步骤操作，请点击启动 VS Code，然后按照演示文稿中的步骤连接到 Gemini Code Assist 并启用它。 Google Cloud
否则，请按照以下步骤操作：
启动 IDE。
在活动栏中，点击 Gemini Code Assist。
在 Gemini Code Assist 聊天窗格中，点击登录 Google Cloud。
当系统提示您允许 Gemini Code Assist 打开外部网站时，请点击 Open（打开）。
按照提示登录您的 Google 账号。
当系统询问您是否从 Google 下载了 Gemini Code Assist 时，请点击登录。
您现在已连接到 Google Cloud。
接下来，如需选择 Google Cloud 已启用 Gemini for Google Cloud API 的项目，请按以下步骤操作：
在 Gemini Code Assist 状态栏中，点击 Gemini Code Assist。
在 Gemini Code Assist 菜单中，选择 Select Gemini Code project（选择 Gemini Code 项目）。
选择 Google Cloud 已启用 Gemini for Google Cloud API 的项目。
Gemini Code Assist 已可供使用。
IntelliJ
如需登录您的 Google 账号，请按以下步骤操作：
在活动栏中，点击 spark Gemini Code Assist。
点击登录 Google。
在网络浏览器中打开的页面上，选择您的 Google 账号。
在要求您确保自己是从 Google 下载此应用的屏幕上，点击登录。
Gemini Code Assist 现有权访问您的账号。
接下来，如果这是您首次在 IDE 中使用 Gemini，则必须按照以下步骤选择一个 Google Cloud 项目：
返回您的 IDE。在 Gemini Code Assist 工具窗口中，如果您同意 Google 代表您为所选项目启用使用 Gemini Code Assist 所需的 API，请点击选择一个 GCP 项目以继续。
在 Select Google Cloud Project（选择 Google Cloud 项目）对话框中，搜索并选择您的 Google Cloud 项目，然后点击 OK（确定）。
点击完成。
系统选择了已启用 Gemini Code Assist API 的 Google Cloud 项目。您现在可以在 IDE 中使用 Gemini 了！
与 Gemini Code Assist 聊天
在本部分中，您将提示 Gemini Code Assist 解释现有代码。
VS Code
如需获取代码的说明，请按以下步骤操作：
打开您的代码文件。
在 IDE 的活动栏中，点击 spark Gemini Code Assist。
在 Gemini Code Assist 窗格中，输入提示
Explain this code to me，然后点击 send Send（发送）。Gemini 会使用代码文件中的代码作为对问题的参考，并在回答中提供代码说明。
如需引用特定代码块（而非文件中的所有代码），您可以在代码文件中选择该代码块，然后提示 Gemini。
IntelliJ
如需获取代码的说明，请按以下步骤操作：
在 IDE 中，打开代码文件。
在 Gemini Code Assist 工具窗口中，输入提示
Explain this code to me，然后点击提交。
Gemini Code Assist 会使用代码文件中的代码作为对问题的参考，并在回答中提供代码说明。
如果您只想了解代码的某个部分，可以选择相应代码，然后再次提示 Gemini Code Assist。Gemini Code Assist 只会将所选代码用作其生成的回答的参考。
当 Gemini Code Assist 在其回答中为您提供代码时，您可以选择其回答末尾列出的以下选项：
Insert at Cursor：将生成的代码插入当前文件的当前光标位置。
Insert in New File（插入新文件）：打开一个新文件，并将生成的代码插入到该新文件中。
当 Gemini Code Assist 识别出代码块中使用的语言，并且当前 IDE 支持该语言时，这些选项才可用。
查看查询历史记录
如果您想重复使用之前的提示，可以点击 Gemini Code Assist 工具窗口中的 schedule Show Query History，在查询记录中找到它们。
重置聊天记录
在回答你的问题时，Gemini Code Assist 会使用聊天记录来获取更多上下文信息。如果聊天记录与您要达成的目标不再相关，您可以重置聊天记录：
VS Code
在 Gemini Code Assist 窗格中，依次点击 delete Reset Chat（重置对话）。
IntelliJ
在 Gemini Code Assist 工具窗口中，依次点击 delete Clear 对话记录。这也会清除您的查询记录。
根据提示生成代码
以下部分将向您展示如何使用 Gemini Code Assist 在代码文件中使用示例提示 Function to create a Cloud Storage
bucket 生成代码。您还可以选择代码的一部分，然后通过聊天功能向 Gemini Code Assist 寻求帮助，并在编码时接收代码建议并接受或拒绝这些建议。
VS Code
使用代码转换功能提示 Gemini Code Assist
借助代码转换功能，您可以使用快捷选择菜单中的命令或自然语言提示请求修改代码，并提供一个差异视图来显示代码的待处理更改。如需提示 Gemini Code Assist 进行代码转换，请按以下步骤操作：
在新代码文件中，另起一行，按 Control+I（适用于 Windows 和 Linux）或 Command+I（适用于 macOS）以打开 Gemini Code Assist Quick Pick 栏。
在菜单中，使用
/generate命令输入/generate function to create a Cloud Storage bucket，然后按 Enter 键（适用于 Windows 和 Linux）或 Return 键（适用于 macOS）。
Gemini Code Assist 会在差异视图中根据您的提示生成代码。
可选：如要接受这些更改，请点击接受。
在代码文件中使用注释向 Gemini Code Assist 发出提示
如果您愿意，也可以在代码文件中留一条注释，以向 Gemini Code Assist 发出提示，具体步骤如下：
另起一行，输入注释
Function to create a Cloud Storage bucket，然后按 Enter（适用于 Windows 和 Linux）或 Return（适用于 macOS）。如需生成代码，请按 Control+Enter（适用于 Windows 和 Linux）或 Control+Return（适用于 macOS）。
在代码文件中的提示文本旁边，Gemini Code Assist 会以幽灵文本的形式生成代码。
可选：若要接受生成的代码，请按 Tab 键。
使用聊天功能向 Gemini Code Assist 提示所选代码
Gemini Code Assist 可以根据您选择的代码执行任务或解答您的问题。如需获取基于包含所选代码的提示生成的代码，请按以下步骤操作：
在活动栏中，点击 spark Gemini Code Assist 以打开 Gemini Code Assist 窗格。
在代码文件中，选择一段代码。
在 Gemini Code Assist 窗格文本字段中，为所选代码输入提示。
例如，在代码中选择一个函数，然后输入提示
Write a unit test for this function：
Gemini 会使用您选择的代码作为参考，并根据您的问题做出回答。
IntelliJ
使用代码转换功能提示 Gemini Code Assist
借助代码转换功能，您可以使用快捷选择菜单中的命令或自然语言提示请求修改代码，并提供差异视图来显示代码的待处理更改。如需提示 Gemini Code Assist 进行代码转换，请按以下步骤操作：
在新代码文件中，按 Alt+\（适用于 Windows 和 Linux）或 Cmd+\（适用于 macOS）打开 Gemini Code Assist Quick Pick 菜单。
在菜单中，使用
/generate命令输入/generate function to create a Cloud Storage bucket，然后按 Enter（适用于 Windows 和 Linux）或 Return（适用于 macOS）键。
Gemini Code Assist 会在差异视图中根据您的提示生成代码。
可选：如要接受这些更改，请点击接受更改。
您可以在 IDE 中使用以下代码转换命令：
/fix：修正代码中的问题或错误。示例：/fix potential NullPointerExceptions in my code。/generate：生成代码。示例：/generate a function to get the current time。/doc：为代码添加文档。示例：/doc this function。/simplify：简化代码。示例：/simplify if statement in this code。
在代码文件中使用注释向 Gemini Code Assist 发出提示
在代码文件中，另起一行输入注释
Function to create a Cloud Storage bucket。如需生成代码，请按 Alt+G（适用于 Windows 和 Linux）或 Option+G（适用于 macOS）。或者，您也可以点击注释旁边的右键，然后选择生成代码。
Gemini Code Assist 会以幽灵文本的形式在注释下方生成代码。
可选：若要接受生成的代码，请按 Tab 键。
使用聊天功能向 Gemini Code Assist 提示所选代码
Gemini Code Assist 可以根据您选择的代码执行任务或解答您的问题。如需获取基于包含所选代码的提示生成的代码，请按以下步骤操作：
在活动栏中，点击 spark Gemini Code Assist 以打开 Gemini Code Assist 工具窗口。
在代码文件中，选择一段代码。
在 Gemini Code Assist 工具窗口文本字段中，为所选代码输入提示。
例如，在代码中选择一个函数，然后输入提示
Write a unit test for this function.Gemini Code Assist 会使用您选择的代码作为参考，并根据您的提示做出回应。
可选：更改用于生成代码的键盘快捷键
如果用于生成代码的默认键盘快捷键无法按上一部分中所述的方式运行，您可以按照以下步骤更改键盘快捷键：
VS Code
在 IDE 中，点击 File（适用于 Windows 和 Linux）或 Code（适用于 macOS），然后依次前往 Settings > Keyboard Shortcuts。
在键盘快捷键列表中，滚动到 Gemini Code Assist: Generate code（Gemini Code Assist：生成代码）。
点击 Gemini Code Assist：Generate Code，然后点击 edit Change Keybinding。
在随即显示的对话框中，输入您自己的快捷键。
按 Enter（适用于 Windows 和 Linux）或 Return（适用于 macOS）。
现在，您可以使用新分配的快捷键通过 Gemini Code Assist 生成代码。
如需详细了解如何在 IDE 中更改快捷键，请参阅 Visual Studio Code 的按键绑定。
IntelliJ
依次前往 settings IDE 和项目设置 > 设置 > 键映射 > Gemini 代码辅助。
右键点击 Gemini Code Assist，然后选择 Add Keyboard Shortcut。
输入您偏好的键盘快捷键，然后点击确定。
右键点击 Gemini Code Assist，然后选择移除 Alt+G（适用于 Windows 和 Linux）或移除 Option+G（适用于 macOS）。
现在，您可以使用新的键盘快捷键在代码文件中生成代码。
获取代码补全
在您编写代码时，Gemini Code Assist 会提供内嵌代码建议（也称为代码补全），您可以选择接受或忽略这些建议。如需获取代码补全功能，请按以下步骤操作：
VS Code
在代码文件中，另起一行，开始编写函数。例如，如果您在 Python 文件中，请编写
def。Gemini Code Assist 会以虚拟文本的形式提供代码建议。
若要接受 Gemini Code Assist 给出的代码建议，请按 Tab 键。否则，若要忽略建议，请按 Esc 或继续编写代码。
IntelliJ
在代码文件中，另起一行，开始编写函数。例如，如果您在 Python 文件中，请编写
def。Gemini Code Assist 会以内嵌建议的形式提供代码建议。
若要接受 Gemini Code Assist 给出的代码建议，请按 Tab 键。否则，若要忽略建议，请按 Esc 或继续编写代码。
可选：如果您想使用其他快捷键接受内嵌建议，请将光标悬停在内嵌建议上，然后点击显示的 Tab 下拉菜单。然后，选择您的首选快捷键，或点击自定义输入您自己的快捷键。
可选：停用代码补全
代码补全功能默认处于启用状态。如果您想停用代码补全功能，请按以下步骤操作：
VS Code
在 IDE 中，点击 Code（适用于 macOS）或 File（适用于 Windows 和 Linux），然后依次前往 Settings > Settings。
在 Settings（设置）对话框的 User（用户）标签页中，依次选择 Extensions（扩展程序）> Gemini Code Assist（Gemini Code Assist）。
滚动屏幕，找到 Duet AI：内嵌建议：启用自动列表，然后选择关闭。
这会关闭内嵌建议。您仍然可以按 Control+Enter（适用于 Windows 和 Linux）或 Control+Return（适用于 macOS）手动触发内嵌建议。
IntelliJ
在 IDE 的状态栏中，点击 spark Gemini Code Assist：Active，然后选择 Enable AI Code Completion（启用 AI 代码补全）。
这会停用代码补全设置，在您重新启用该设置之前，Gemini Code Assist 将不再提供内嵌建议。
使用智能操作
为了在最大程度减少上下文切换的同时提高效率，Gemini Code Assist 直接在代码编辑器中提供 AI 赋能的智能操作。在代码编辑器中选择代码时，您可以查看与上下文相关的操作列表，并从中进行选择。
如需在代码中使用智能操作，请按以下步骤操作：
VS Code
在代码文件中，选择一段代码。
在所选代码块旁边，点击 lightbulb Show Code Actions（显示代码操作）。
选择一个操作，例如生成单元测试。
Gemini 会根据您选择的操作生成回答。
IntelliJ
在代码文件中，选择一行或一块代码。
右键点击所选代码，然后选择某个智能操作，例如生成单元测试。
选择智能操作后，Gemini Code Assist 会自动在 Gemini Code Assist 工具窗口中针对提示生成回答。
使用代码转换快速修复
如果代码中存在错误，Gemini Code Assist 可让您通过代码转换对错误应用快速修复。
如需在代码文件中应用快速修复，请按以下步骤操作：
VS Code
在代码文件中，将指针悬停在波浪形错误行上，选择快速修复，然后选择 /fix。
应用快速修复后，系统会显示差异视图。如要接受这些更改，请点击接受。
IntelliJ
在代码文件中，点击红色的错误灯泡图标（表示代码中存在错误），然后选择 Fix with Gemini（使用 Gemini 进行修复）。
应用修复程序后，系统会显示差异视图。如要接受这些更改，请点击接受。
在您的工作区中提示特定文件，并具有本地代码库感知
本地代码库感知功能可帮助您指定要供 Gemini Code Assist 用作上下文的文件，从而提供在代码库更广泛上下文中语法正确且具有语义意义的高质量代码建议。
如需在聊天提示中指定文件，请输入 @，然后选择要指定的文件。
如需了解代码库中两个文件的差异，请按以下步骤操作：
在活动栏中，点击 spark Gemini Code Assist。
在 Gemini Code Assist 窗格中，输入提示
Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2，然后按 Enter（适用于 Windows 和 Linux）或 Return（适用于 macOS）或 Tab。您也可以点击列表中的文件名称来选择文件。点击文件名会将该文件添加到提示上下文，并在 IDE 中打开该文件。Gemini Code Assist 会使用您指定的两个文件作为上下文来回答您的问题。Gemini Code Assist 还包含您在上下文来源中指定的文件。
现在，您已指定这些文件，接下来便可以在同一对话记录中继续询问其他问题或提示，而无需再次指定文件。
例如：在 Gemini Code Assist 窗格中，输入提示 How can I
improve YOUR_FILE_NAME_1?（不带 @ 符号），然后按 Enter（适用于 Windows 和 Linux）或 Return（适用于 macOS）。
Gemini Code Assist 会回答您对提示中指定的文件提出的问题。
可选：使用 .aiexclude 文件将文件从上下文中排除
您可以创建 .aiexclude 文件，以排除 Gemini Code Assist 在考虑上下文时要考虑的文件。.aiexclude 文件遵循与 .gitignore 文件类似的语法，但存在以下差异：
- 空的或不存在的
.aiexclude文件不会阻止其目录及其所有子目录中的任何文件。 .aiexclude文件不支持否定运算，即在模式前面添加感叹号 (!)。.aiexclude文件会贪婪地匹配*字符。这将不加区分地匹配目录和文件。此.aiexclude文件不会区分文件夹或文件的**或*。
目前仅支持单个 .aiexclude 文件。如需配置 .aiexclude 文件，请在工作区文件夹的根目录中创建一个名为 .aiexclude 的文件。
示例
以下示例展示了如何配置 .aiexclude 文件：
屏蔽工作区目录中或下方的所有名为
apikeys.txt的文件：apikeys.txt在工作区目录或该目录下阻止所有扩展名为
.key的文件：*.key仅屏蔽与
.aiexclude文件位于同一目录中的 apikeys.txt 文件，但不屏蔽任何子目录：/apikeys.txt屏蔽
my/sensitive/dir目录及其所有子目录中的所有文件。路径应相对于工作区根目录。my/sensitive/dir/*
停用与引用的来源匹配的代码建议
当 Gemini Code Assist 直接引用其他来源（例如现有开源代码）的长篇内容时，会提供引用信息。如需了解详情，请参阅 Gemini 会注明信息来源的情况和方式。
如需防止系统向您推荐与所引用来源匹配的代码，请执行以下操作：
在 IDE 的活动栏中，依次点击 Manage（管理）> Settings（设置）。
在设置窗口的 User（用户）标签页中，依次选择 Extensions（扩展程序）> Gemini Code Assist（Gemini Code Assist）。
滚动屏幕，找到 Duet AI > Recitation: Max Cited Length。
将值设置为
0。Gemini Code Assist 不再向您建议与引用的来源匹配的代码。
已知问题
本部分概述了 Gemini Code Assist 的已知问题：
VS Code
如果聊天回复包含打开的大型文件的更新版本，则可能会被截断
如需解决此问题，请选择较小的代码段，并在聊天提示中添加其他指令，例如
only output the selected code.Vim：除非处于插入模式，否则无法接受或关闭代码生成建议
在正常模式下使用 Vim 插件时，您无法接受或关闭代码建议。
如需解决此问题，请按 i 进入插入模式，然后按 Tab 键接受建议。
Vim：按 Esc 键关闭建议时行为不一致
按 Esc 时，IDE 和 Gemini 建议都会关闭。此行为与非 Vim 行为不同，在非 Vim 行为中，按 Esc 会重新触发 Gemini。
登录尝试会不断超时
如果您的登录尝试一直超时，请尝试向
settings.json文件添加cloudcode.beta.forceOobLogin设置："cloudcode.beta.forceOobLogin": true许可朗读警告不会跨会话保留
如果许可朗读警告不会在会话之间保留，请参阅永久性日志：
依次点击视图 > 输出。
选择 Gemini Code Assist - Citations。
Gemini Code Assist 输出窗口中的连接问题
如果您在 Gemini Code Assist 输出窗口中看到连接错误或其他连接问题，请尝试以下操作：
配置防火墙以允许访问
oauth2.googleapis.com和cloudaicompanion.googleapis.com。配置防火墙以允许通过 gRPC 使用的 HTTP/2 进行通信。
您可以使用
grpc-health-probe工具测试连接。成功完成检查后，您会看到以下输出：$ grpc-health-probe -addr cloudaicompanion.googleapis.com:443 -tls error: this server does not implement the grpc health protocol (grpc.health.v1.Health): GRPC target method can't be resolved如果检查失败，则会生成以下输出：
timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s如需获取更多详细信息，请在
grpc-health-probe之前运行以下命令：export GRPC_GO_LOG_SEVERITY_LEVEL=info
选择 Gemini Code Assist 项目后，系统仍会显示“激活 Gemini Code Assist”
如果您按照本指南中的说明（包括启用 Gemini for Google Cloud API）选择了项目，则 LS 服务器可能存在问题。
如需详细了解您的问题，请执行以下操作：
在状态栏中，点击 spark Gemini Code Assist，然后选择 Send feedback（发送反馈）。
点击任意日志文件的显示，即可查看更多详细信息，以便排查问题。
IntelliJ
Gemini Code Assist for IntelliJ 和其他受支持的 JetBrains IDE 没有已知问题。
提供反馈
如需就使用体验留下反馈，请按以下步骤操作：
VS Code
在状态栏中，点击 spark Gemini Code Assist，然后在 Quick Pick 菜单中，选择 Send feedback。
在表单中，填写标题和备注字段。
如果您想分享 Skaffold 或 AI 同伴日志，请务必选择发送 Skaffold 日志或发送 AI 同伴日志选项。
点击提交反馈。
IntelliJ
在状态栏中，点击 spark Gemini Code Assist，然后在菜单中选择 Submit feedback（提交反馈）。
在表单顶部的文本字段中，输入您的反馈。
如果您想分享 Gemini Code Assist 日志，请务必选择日志文件。
点击提交反馈。
后续步骤
- 了解如何撰写更实用的提示。
- 了解 适用于 Google Cloud 的 Gemini 如何使用您的数据。 Google Cloud
- 了解 Gemini Code Assist 的价格。
- 详细了解 Google Cloud 合规性。