使用 Gemini Code Assist 编写代码

本文档介绍了如何使用 Gemini Code Assist(Google Cloud 中依托 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 and Project Settings > Plugins
  2. Marketplace 标签页中,搜索 Gemini Code Assist/Cloud Code
  3. 点击 Install 以安装该插件。
  4. 安装完成后,点击 Restart IDE
  5. IDE 重启后,Gemini Code Assist 会显示在 activity 栏中。

    Gemini Code Assist 图标显示在活动栏中

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

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

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

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

  1. 在活动栏中,点击 sparkGemini 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 提问 代码助手:

  • 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 显示查询历史记录

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

您的查询和对话记录会跨 IDE 会话保留。清除查询 和对话记录,请点击 delete 清除会话历史记录

点击此按钮可清除 Gemini 工具窗口中的对话记录。

根据提示生成代码

以下部分将介绍如何使用 Gemini Code Assist 在代码文件中使用示例提示 Function to create a Cloud Storage bucket 生成代码。你还可以选择代码的一部分 通过聊天功能提示 Gemini Code Assist 获取帮助,并接收和 接受或拒绝代码建议。

在代码文件中使用注释向 Gemini Code Assist 发出提示

  1. 在您的代码文件中,另起一行输入注释 Function to create a Cloud Storage bucket

  2. 若要生成代码,请按 Alt+Shift+\(适用于 Windows 和 Linux)或 Option+Shift+\(适用于 macOS)。或者,您可以右键点击“下一步” 添加到注释中,然后选择 Generate Code(生成代码)。

    Gemini Code Assist 会以幽灵文本的形式在注释下方生成代码。

  3. 可选:若要接受生成的代码,请按 Tab

通过聊天使用所选代码向 Gemini Code Assist 发出提示

Gemini Code Assist 可以根据您选择的代码执行任务或解答您的问题。为了获得基于 提示,请按以下步骤操作:

  1. 在活动栏中,点击 spark Gemini Code Assist 以打开 Gemini Code Assist 工具窗口。

  2. 在您的代码文件中,选择一个代码块。

  3. Gemini Code Assist 工具窗口文本字段中,输入关于 所选代码。

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

    Gemini Code Assist 会使用您选择的代码作为参考,并根据您的提示做出回应。

获取代码补全

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

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

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

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

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

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

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

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

这会停用代码补全设置,并且 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+\;对于 macOS,为 Option+Shift+\)与最近推出的 JetBrains 代码补全快捷键重叠。

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

  1. 依次选择 settings IDE 和项目设置 > 设置 > 键映射 > Gemini 代码辅助

  2. 右键点击 Gemini Code Assist,然后选择 Add Keyboard Shortcut

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

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

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

提供反馈

如需就您的体验提供反馈,请按以下步骤操作:

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

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

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

  4. 点击提交反馈

后续步骤