与 Gemini Code Assist 个人版对话

VS Code

1. 设置 Gemini Code Assist 个人版、Gemini Code Assist Standard 或 Gemini Code Assist Enterprise（如果尚未设置）。

2. 在代码文件中测试 Gemini Code Assist 功能之前，请确保您的文件所使用的编程语言受支持。如需详细了解支持的编码语言，请参阅支持的编码语言。

3. 如果您倾向于在代理环境下使用 IDE，请参阅 Visual Studio Code 中的网络连接。

IntelliJ

1. 设置 Gemini Code Assist 个人版、Gemini Code Assist Standard 或 Gemini Code Assist Enterprise（如果尚未设置）。

2. 在代码文件中测试 Gemini Code Assist 功能之前，请确保您的文件所使用的编程语言受支持。如需详细了解支持的编码语言，请参阅支持的编码语言。

3. 如果您倾向于在代理环境下使用 IDE，请参阅 HTTP 代理。

VS Code

如需获取代码的说明，请按以下步骤操作：

1. 打开您的代码文件。

2. 在 IDE 的活动栏中，点击 spark Gemini Code Assist。

3. 在 Gemini Code Assist 窗格中，输入提示 Explain this code to me，然后点击 send 发送。

   Gemini Code Assist 会将代码文件中的内容作为提示参考，并返回解释结果。

   如需引用特定代码块（而不是文件中的所有代码），您可以选择代码文件中的代码块，然后提示 Gemini Code Assist。

IntelliJ

如需获取代码的说明，请按以下步骤操作：

1. 在 IDE 中，打开您的代码文件。

2. 在 Gemini Code Assist 工具窗口中，输入提示 Explain this code to me，然后点击提交。

Gemini Code Assist 会将代码文件中的内容作为提示参考，并返回解释结果。

如果您只想了解代码的某个部分，可以选择相应代码，然后再次提示 Gemini Code Assist。Gemini Code Assist 仅会将所选代码作为生成回答的参考内容。

Gemini Code Assist 在其回答中为您提供代码时，您可以选择回答末尾列出的以下选项：

• 在光标处插入：将生成的代码插入到当前文件的当前光标位置。

• 插入到新文件：打开一个新文件，并将生成的代码插入到该新文件中。

  

当 Gemini Code Assist 识别出代码块中使用的语言，并且当前 IDE 支持该语言时，这些选项才可用。

查看查询历史记录

如果您想重复使用之前的提示，可以点击 schedule 显示查询记录，前往 Gemini Code Assist 工具窗口，在查询记录中找到这些提示。

VS Code

1. 如需添加新对话，请点击 add 发起新对话，然后在文本字段中输入提示。输入提示后，Gemini Code Assist 会创建新对话。
2. 如需访问之前的对话，请点击 history 继续之前的对话。系统会显示您的对话列表。选择要查看的对话。
3. 如需删除对话消息串，请点击继续之前的对话，然后点击要删除的对话旁边的 delete 删除。

IntelliJ

1. 如需添加新对话，请点击 add 发起新对话，然后在文本字段中输入提示。输入提示后，Gemini Code Assist 会创建新对话。
2. 如需访问之前的对话，请点击 chat_bubble 最近的对话。系统会显示您的对话列表。选择要查看的对话。
3. 如需删除对话消息串，请点击最近的对话，然后点击要删除的对话旁边的 删除 删除。

VS Code

默认情况下，Gemini Code Assist 会自动滚动浏览对话。如需停用此行为，请执行以下任务：

1. 依次前往设置 > 扩展程序 > Gemini Code Assist。

2. 搜索自动滚动设置，然后取消选中相应复选框。

IntelliJ

Gemini Code Assist for IntelliJ 和其他 JetBrains IDE 不支持此功能。

VS Code

您可以按 stop 停止来停止正在进行的对话回答：

IntelliJ

您可以按 stop 停止来停止正在进行的对话回答：

VS Code

1. 在对话窗格中，将指针悬停在要修改的提示上。

2. 依次点击修改 修改。

   

3. 更改提示，然后点击更新。

   Gemini Code Assist 会根据您修改的提示生成新的回答。

IntelliJ

1. 在对话窗格中，将指针悬停在要修改的提示上。

2. 依次点击修改 修改。

   

3. 更改提示，然后点击更新。

   Gemini Code Assist 会根据您修改的提示生成新的回答。

VS Code

在 Gemini Code Assist 对话窗格中，点击最新回答底部的重放图标 重新生成回答。

Gemini Code Assist 会重新评估您最近的提示，并提供新的回答。

IntelliJ

在 Gemini Code Assist 对话窗格中，点击最新回答底部的重放图标 重新生成回答。

Gemini Code Assist 会重新评估您最近的提示，并提供新的回答。

VS Code

1. 在对话窗格中，将指针悬停在要移除的提示上。

2. 点击删除。

   

3. 当系统提示您确认是否要删除提示和回答对时，请选择删除。否则，请点击取消以取消操作。

   您的提示和回答对会从您与 Gemini Code Assist 的对话记录中移除。

IntelliJ

1. 在对话窗格中，将指针悬停在要移除的提示上。

2. 点击删除。

   

3. 当系统提示您确认是否要删除提示和回答对时，请选择删除。否则，请点击取消以取消操作。

   您的提示和回答对会从您与 Gemini Code Assist 的对话记录中移除。

VS Code

1. 在 IDE 中，依次前往设置 > 扩展程序 > Gemini Code Assist。

2. 搜索默认代码块显示设置。

3. 从下列选项中选择一项：

   • 展开：自动展开 Gemini Code Assist 对话回答中的所有代码块。

   • 预览：仅显示代码块中的前 6 行代码。您必须展开 Gemini Code Assist 对话回答中的代码块，才能看到其余代码。这是默认设置。

   • 收起：自动收起 Gemini Code Assist 对话回答中的所有代码块。

   当 IDE 重新加载时，新设置会生效。

IntelliJ

此功能是 IntelliJ Gemini Code Assist 和其他 JetBrains IDE 中的默认功能，无法配置。

VS Code

1. 在活动栏中，点击 spark Gemini Code Assist 以打开 Gemini Code Assist 窗格。

2. 在代码文件中，选择一个代码块。

3. 在 Gemini Code Assist 窗格文本字段中，输入所选代码的提示。

   例如，在代码中选择一个函数，然后输入提示 Write a unit test for this function。

   Gemini 会将您选择的代码作为参考，并生成对提示的回答。

IntelliJ

1. 在活动栏中，点击 星光图标 Gemini Code Assist，打开 Gemini Code Assist 工具窗口。

2. 在代码文件中，选择一个代码块。

3. 在 Gemini Code Assist 工具窗口文本字段中，输入所选代码的提示。

   例如，在代码中选择一个函数，然后输入提示 Write a unit test for this function.

   Gemini Code Assist 会将您选择的代码作为参考，并生成对提示的回答。

VS Code

1. 在代码文件中，选择一个代码段。

2. 在 Gemini Code Assist 对话文本字段中，点击添加到对话上下文。

   Gemini Code Assist 会将所选代码段添加到上下文抽屉式导航栏中。

3. 在 Gemini Code Assist 对话文本字段中，输入提示 what does this code do?。

   Gemini Code Assist 会根据您在上下文抽屉式导航栏中选择的代码段来回答您的提示。

IntelliJ

1. 在代码文件中，选择一个代码段。

2. 选择 spark Gemini 图标，然后从菜单中选择将所选文本添加到 Chat。

   代码段已添加到上下文抽屉式导航栏中。

VS Code

1. 在 IDE 中，打开终端（视图 > 终端）。

2. 选择任意终端输出。

3. 右键点击所选终端输出，然后选择 Gemini Code Assist：添加到对话上下文。

   Gemini Code Assist 会将终端输出添加到上下文抽屉式导航栏中。

4. 在 Gemini Code Assist 对话文本字段中，输入提示 what does this do?。

   Gemini Code Assist 会根据您在上下文抽屉式导航栏中选择的终端输出来回答您的提示。

IntelliJ

1. 在 Gemini Code Assist 对话文本字段中，输入 @terminal。

2. 在随即显示的列表中，选择终端下要查询的终端。

   

3. 在 Gemini Code Assist 对话文本字段中，输入提示 what does this do?。

   Gemini Code Assist 会根据您选择的终端输出来回答您的提示。

VS Code

如需在对话提示中指定文件或文件夹，请输入 @，然后选择要指定的文件或文件夹。

如需了解代码库中两个文件的区别，请按以下步骤操作：

1. 在活动栏中，点击 spark Gemini Code Assist。

2. 在 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 会根据您在提示中指定的文件回答您的问题。

IntelliJ

如需在对话提示中指定文件或文件夹，请输入 @，然后选择要指定的文件或文件夹。

如需了解代码库中两个文件的区别，请按以下步骤操作：

1. 在活动栏中，点击 spark Gemini Code Assist。

2. 在 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 会根据您在提示中指定的文件回答您的问题。

VS Code

1. 在 IDE 的活动栏中，点击 spark Gemini Code Assist。

2. 如需查看上下文抽屉式导航栏中的文件和文件夹，请点击上下文项。

   

3. 如需从上下文抽屉式导航栏中移除各项，请点击 close 移除。

IntelliJ

1. 在活动栏中，点击 spark Gemini Code Assist。

2. 如需查看上下文抽屉式导航栏中的文件和文件夹，请点击上下文。

   

3. 如需从上下文抽屉式导航栏中移除文件和文件夹，请点击 close 移除。

VS Code

在 Gemini Code Assist 对话窗格中，依次点击撤消 还原到检查点。这会将您的代码文件还原到进行修改之前的检查点状态。

IntelliJ

如果您已点击对话生成的代码建议中的勾号 接受更改，则可以选择使用撤销 回滚更改按钮来回滚更改：

在 Gemini Code Assist 对话窗格中，依次点击撤销 回滚更改。这会将您的代码文件还原到进行修改之前的检查点状态。

VS Code

1. 打开代码文件后，提示 Gemini Code Assist optimize this file。如果您想优化多个文件和文件夹，请提示 Gemini Code Assist optimize @FILE1 and @FILE2。

   Gemini Code Assist 会在代码文件中针对您的提示提供代码更改建议，并提供内嵌差异来展示这些更改。

2. 在代码文件中，点击 check_small 接受或 close_small 拒绝。

   

3. 如果 Gemini Code Assist 在您的代码文件中建议了多个更改，请点击建议上方的查看，然后点击下一个或上一个，以循环浏览其他建议。

4. 如果您想接受或拒绝所有建议的更改，请点击接受文件或拒绝文件。

   

5. 您还可以使用提示回答中的“快速预览”，接受或拒绝多个代码文件中的所有建议。

   

IntelliJ

1. 打开代码文件后，提示 Gemini Code Assist optimize this file。如果您想优化多个文件和文件夹，请提示 Gemini Code Assist optimize @FILE1 and @FILE2。

   Gemini Code Assist 会在代码文件中针对您的提示提供代码更改建议，并在对话回答中提供说明这些更改的差异。

2. 在对话回答中，点击 check_small 接受更改。

   

VS Code

如果您愿意，可以按照以下步骤更改此设置，以便在 IDE 中显示单独的差异视图窗口：

1. 在活动栏中，依次前往设置 设置 > 设置。

2. 在设置的用户标签页中，依次前往扩展程序 > Gemini Code Assist。

3. 滚动到 Geminicodeassist > 对话：更改视图设置。

4. 在下拉列表中，选择以下选项之一：

   • 内嵌建议（默认处于启用状态）：显示在代码文件中的代码更改。
   • 默认差异视图：打开一个新文件，其中并排显示代码更改。

IntelliJ

目前，Gemini Code Assist for IntelliJ 和其他受支持的 JetBrains IDE 不支持此功能。

VS Code

1. 在代码文件中，按 Ctrl+I（适用于 Windows 和 Linux）或 Command+I（适用于 macOS），以打开 Gemini Code Assist 快速选择菜单。

2. 在该菜单中，搜索并选择首选项：打开设置 (UI)。

3. 在搜索设置字段中，输入 Geminicodeassist: Custom Commands。

4. 在自定义命令框中，选择添加项。

5. 在项字段中，输入 add-comments 作为命令的名称。

6. 在值字段中，输入 add comments to all functions without comments in my code 作为提示。

7. 点击确定。

您现在可以在 IDE 中使用自定义命令 add-comments。该命令会显示在“Gemini Code Assist 快速选择”菜单（Ctrl+I [适用于 Windows 和 Linux] 或 Command+I [适用于 macOS]）的命令列表中。

IntelliJ

1. 在 IDE 中，依次前往设置 > 工具 > Gemini > 提示库。

   

2. 在提示库窗口中，点击 add 添加。

3. 将自定义命令命名为 add-comments。

4. 在提示库的文本框中，输入提示：Add comments to all functions without comments in this code。

5. 选中在编辑器内提示中显示复选框（如果未选中）。

6. 点击确定，将自定义命令保存在提示库中。

7. 在代码文件中，突出显示要修改的代码。

8. 右键点击突出显示的代码，依次前往 Gemini > 提示库，然后选择自定义命令 add-comments。

   Gemini Code Assist 会执行 add-comments 命令，并向突出显示的代码添加注释。

您还可以通过执行以下任务，使用编辑器内提示调用自定义命令：

1. 在代码文件中，突出显示要修改的代码，然后按 Alt+\（适用于 Windows 和 Linux）或 Cmd+\（适用于 macOS），以打开 Gemini Code Assist 快速选择菜单。

2. 在菜单中，选择您的自定义指令 add-comments。

   Gemini Code Assist 会执行 add-comments 命令，并向突出显示的代码添加注释。

在 Gemini Code Assist 对话窗格中，您可以输入 @，以检索并使用提示库中保存的提示。

VS Code

1. 在代码文件中，按 Ctrl+I（适用于 Windows 和 Linux）或 Command+I（适用于 macOS），以打开 Gemini Code Assist 快速选择菜单。

2. 在该菜单中，搜索并选择首选项：打开设置 (UI)。

3. 在搜索设置字段中，输入 Geminicodeassist: Rules。

4. 在文本字段中，输入规则，例如：Always generate unit tests when creating a new function。您还可以在文本字段中添加包含多行的一条或多条规则。

   在“规则”设置中添加规则后，Gemini Code Assist 会在您每次发出提示或请求时考虑相应规则。

   如需移除规则，请从“规则”文本字段中删除相应内容。

IntelliJ

1. 如需创建规则，请依次前往设置 > 工具 > Gemini > 提示库 > 规则，然后在编辑器中修改文本。

2. 如需设置规则的范围，请在范围下拉菜单中选择 IDE 或项目。

   • IDE 级规则仅供您自己使用，并且可用于多个项目。
   • 项目级规则可以在处理同一项目的团队成员之间共享。

   如需在整个团队中共享提示，您必须将 .idea 文件夹添加到版本控制系统。

VS Code

• 如果对话回答包含大型打开文件的更新版本，可能会被截断

  如需解决此问题，请选择较小的一小段代码，并在对话提示中添加额外的指令，例如 only output the selected code.

• Vim：除非处于插入模式，否则无法接受或拒绝代码生成建议

  在常规模式下使用 Vim 插件时，您无法接受或忽略代码建议。

  如需解决此问题，请按 i 键进入插入模式，然后按 Tab 键接受建议。

• Vim：按 Esc 键以忽略建议时行为不一致

  按 Esc 键时，IDE 和 Gemini Code Assist 建议都会关闭。此行为与非 Vim 行为不同，后者在按下 Esc 键时会重新触发 Gemini Code Assist。

• 登录尝试反复超时

  如果您的登录尝试反复超时，请尝试将 cloudcode.beta.forceOobLogin 设置添加到 settings.json 文件中：

   "cloudcode.beta.forceOobLogin": true
  

• 许可引用警告不会在各个会话之间保留

  如果许可引用警告无法在各会话中保留，请查阅持久性日志：

  1. 依次点击视图 > 输出。

  2. 选择 Gemini Code Assist - 引用。

• Gemini Code Assist 输出窗口中的连接问题

  如果您在 Gemini Code Assist 输出窗口中看到连接错误或其他连接问题，请尝试以下操作：

  • 配置防火墙以允许访问 oauth2.googleapis.com 和 cloudaicompanion.googleapis.com。

  • 配置防火墙以允许通过 HTTP/2 进行通信，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
  

IntelliJ

截至目前，Gemini Code Assist for IntelliJ 和其他支持的 JetBrains IDE 暂无已知问题。