使用 Gemini Code Assist 编写代码

本文档介绍了如何使用 Gemini Code Assist 是 AI 赋能的一款应用, 可帮助您在 Cloud Code 中执行以下操作:

  • 提供指导,帮助您解决代码问题。

  • 为您的项目生成代码。

  • 在编码时接收内嵌建议。

了解 Gemini for Google Cloud 如何以及何时使用您的数据

为帮助您遵守代码的所有许可要求,当 Gemini Code Assist 的建议直接引用特定来源的长篇内容时,它会提供来源引用。如需详细了解 Gemini 会注明信息来源的情况和方式,请参阅 Gemini 如何帮助您生成代码并注明信息来源

借助代码自定义功能,您可以直接从 Gemini Code Assist 获取基于贵组织私有代码库的代码建议。了解 如何配置代码自定义

本文档面向各种技能水平的开发者。本文假定您已具备 IntelliJ 的实际运用知识,并熟悉 Google Cloud。如果您愿意,还可以探索 Gemini Code Assist: Cloud Workstations适用于 VS Code 的 Cloud CodeCloud Shell Editor

准备工作

  1. 在代码中测试 Gemini Code Assist 功能之前 文件,请确保系统支持您文件的编码语言。更多信息 请参阅 支持的编程语言

  2. 安装 Gemini Code Assist/Cloud Code 扩展程序 。Gemini Code Assist 和 Cloud Code 是捆绑在一起的。

  3. 如果您希望在代理后面使用 IDE,请参阅 HTTP 代理

安装 Gemini Code Assist 插件

如需在 JetBrains IDE 中安装 Gemini Code Assist 插件,请执行以下操作: 请按以下步骤操作:

  1. 点击 settings IDE 和项目 设置 > 插件
  2. 市场标签页中,搜索“Gemini Code Assist/Cloud Code”。
  3. 点击 Install 安装插件。
  4. 安装完成后,点击 Restart IDE
  5. 当 IDE 重启时,Gemini Code Assist 会显示在您的 活动栏。

    Gemini Code Assist 图标显示在 activity 栏中

现在,您可以在 IDE 中使用 Gemini Code Assist 了。

登录 Google 并选择一个 Google Cloud 项目

在此部分中,您将登录自己的 Google 账号;如果这是您首次登录 在 IDE 中使用 Gemini Code Assist,请选择一个 Google Cloud 项目。

要登录您的 Google 账号,请按以下步骤操作:

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

  2. 点击登录 Google

  3. 在网络浏览器中打开的页面中,选择您的 Google 账号。

  4. 询问您是否确认是从以下来源下载此应用的屏幕上 Google,请点击登录

    Gemini Code Assist 现有权访问您的账号。

接下来,如果这是您第一次在 IDE 中使用 Gemini, 必须按照以下步骤选择 Google Cloud 项目:

  1. 返回您的 IDE。在 Gemini Code Assist 工具窗口中,如果 您同意 Google 启用 Gemini Code Assist 会代表您选择的项目, 点击选择 GCP 项目以继续。

  2. Select Google Cloud Project(选择 Google Cloud 项目)对话框中,搜索并选择您的 Google Cloud 项目,然后点击 OK(确定)。

  3. 点击完成

已选择您的 Google Cloud 项目,并启用了 Gemini Code Assist API。您现在可以在 IDE 中使用 Gemini 了!

与 Gemini Code Assist Chat

在本部分中,您需要提示 Gemini Code Assist 提供 现有代码的说明

如需获取代码说明,请按以下步骤操作:

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

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

    Gemini Code Assist 会将代码文件中的代码用作 引用您的提示,并在回复中提供代码说明。

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

下面是您可以尝试向 Gemini Code Assist 提出的其他一些示例问题:

  • Write unit tests for my code.
  • Help me debug my code.
  • Make my code more readable.

当 Gemini Code Assist 在回答中向你提供代码时,你可以选择其回答末尾列出的以下选项:

  • Insert at Cursor:将生成的代码插入当前文件中,位置为: 您当前光标的位置。

  • Insert in New File:打开新文件并将生成的代码插入到 新文件。

Gemini 会在生成的代码响应末尾列出代码操作。

当 Gemini Code Assist 确定以下各项时,这些选项可用 代码块中使用的语言,以及您的 最新的 IDE。

查看查询历史记录

如果您想重复使用之前的提示,可以点击 schedule Show Query History,在 Gemini Code Assist 工具窗口的查询历史记录中找到它们。

工具窗口中的 Gemini 查询记录。

您的查询和对话历史记录会在 IDE 会话之间保持不变。清除查询 和对话记录,请点击 delete 清除对话记录

Gemini 工具窗口中用于清除对话历史记录的按钮。

获取代码补全信息

在您编写代码时,Gemini Code Assist 会提供内嵌代码建议(称为代码补全),您可以选择接受或忽略这些建议。接收者 要获取代码补全信息,请按以下步骤操作:

  1. 在代码文件中另起一行,开始编写函数。例如,如果您在 Python 文件中,请编写 def

    Gemini Code Assist 以内嵌形式提供代码建议 建议。

  2. 若要接受 Gemini Code Assist 给出的代码建议,请按 Tab 键。否则,若要忽略建议,请按 Esc 或继续编写代码。

  3. 可选:如果您希望使用其他快捷键来接受内联 请将鼠标指针悬停在内嵌建议上,然后点击 Tab 下拉菜单。然后,选择您的首选快捷键,或点击自定义输入您自己的快捷键。

    Gemini 提供了一个下拉菜单,可让您更改快捷方式以接受内嵌建议。

代码补全功能默认处于启用状态。如果要停用代码补全功能 在 IDE 的状态栏中,点击 spark AI 代码补全:已启用,然后选择启用 AI 代码补全

IntelliJ 状态栏中的 Gemini 代码补全按钮。

这会停用代码补全设置,并且 Gemini Code Assist 将不再提供内嵌建议,直到您重新启用该设置为止。

使用智能操作

为了在最大程度减少上下文切换的同时提高效率,Gemini Code Assist 直接在代码编辑器中提供 AI 赋能的智能操作。在代码编辑器中选择代码时,您可以查看 然后从与当前情境相关的操作列表中进行选择。

如需在代码中使用智能操作,请按以下步骤操作:

  1. 在您的代码文件中,选择一行或代码块。

  2. 右键点击所选代码,然后选择一项智能操作,例如 生成单元测试

    选择智能操作后,Gemini Code Assist 会自动在 Gemini Code Assist 工具窗口中生成对相应提示的回答。

从上下文中排除文件

如果您想从 Gemini Code Assist 中排除您的任何文件 完成和聊天互动,您可以创建一个 .aiexclude 文件,该文件用于 其工作原理与 .gitignore 类似。

如需详细了解如何配置 .aiexclude 文件,请参阅使用 .aiexclude 文件配置情境共享

已知问题

以下各部分概要介绍了 Gemini Code Assist 的已知问题。

JetBrains 代码补全快捷方式与 Gemini Code Assist 快捷方式重叠

在 JetBrains 2024.2 版本中,您或许可以使用 Gemini Code Assist 用于代码生成的快捷键(Windows 和 Linux 为 Alt+Shift+\; 或 Option+Shift+\(适用于 macOS)与 JetBrains 代码重叠 最近引入的补全快捷方式。

如需更改 Gemini Code Assist 的快捷键,请执行 以下任务:

  1. 依次前往设置 IDE 和项目设置 > 设置 > 键映射 > Gemini Code Assist

  2. 右键点击 Gemini Code Assist,然后选择添加键盘快捷键

  3. 输入您偏好的键盘快捷键,然后点击确定

  4. 右键点击 Gemini Code Assist,然后选择移除 Alt+Shift+\(适用于 Windows 和 Linux),或 移除 Option+Shift+\(适用于 macOS)。

    现在,您可以使用新的键盘快捷键在代码文件中生成代码。

提供反馈

如需就使用体验留下反馈,请按以下步骤操作:

  1. 在状态栏中,点击 spark AI 代码补全,然后在菜单中选择提交反馈

  2. 在表单顶部的文本字段中,输入您的反馈。

  3. 如果您想分享 Gemini Code Assist 日志,请确保 来选择日志文件

  4. 点击提交反馈

后续步骤