使用 Gemini Code Assist 编写代码

本文档介绍了如何使用 Gemini Code Assist(Google Cloud 中依托 AI 技术的协作工具)帮助您在 Cloud Code 中执行以下操作:

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

  • 为您的项目生成代码。

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

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

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

本文档面向各种技能水平的开发者。本教程假定您具备 IntelliJ 的应用知识,并且熟悉 Google Cloud。如果您愿意,还可以在 Cloud WorkstationsCloud Code for VS CodeCloud Shell Editor 中探索 Gemini Code Assist。

准备工作

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

  2. 安装 Gemini Code Assist/Cloud Code 扩展程序(如果尚未安装)。Cloud Code 会与 IDE 中的 Gemini Code Assist 集成。

连接到 Google Cloud 并选择一个项目

在本部分中,您将连接到 Google Cloud,并选择一个已在 IDE 中启用 Cloud AI Companion API 的 Google Cloud 项目。

如果您选择的 Google Cloud 项目未启用 Cloud AI Companion API,则会收到一条通知,其中包含用于从 IDE 启用 API 的选项。在通知窗口中选择启用 API,为您的项目启用此 API。如需了解详情,请参阅为项目设置 Gemini Code Assist

如需在 IDE 中连接到 Google Cloud,请按以下步骤操作:

  1. 启动 IDE。

  2. 点击工具 > Google Cloud Code > 登录 Google Cloud Platform

  3. 按照提示登录您的 Google 帐号。

  4. 当系统询问您是否从 Google 下载 Cloud Code 时,点击登录

    您现已连接到 Google Cloud。

接下来,如需选择启用了 Cloud AI Companion API 的 Google Cloud 项目,请按以下步骤操作:

  1. Gemini Code Assist 状态栏中,点击 Gemini Code Assist

    Gemini 状态栏按钮。

  2. Gemini Code Assist 菜单中,选择设置

  3. Cloud 项目字段中,点击 more_horiz 选择 Google Cloud 项目,然后选择一个已启用 Cloud AI Companion API 的项目。

    可以开始使用 Gemini 了。

与 Gemini Code Assist Chat

在本部分中,您将了解如何打开 Gemini Code Assist 窗格并与 Gemini Code Assist 对话,以获取现有代码的说明。

如要开始与 Gemini 对话,请按以下步骤操作:

  1. 打开代码文件。

  2. 在状态栏中,点击 Gemini Code Assist,然后选择打开聊天

    Cloud Code 状态栏中的 Gemini 按钮会显示“打开聊天”选项。

  3. Gemini Code Assist 聊天窗口中,输入提示 Explain this code to me,然后点击 Send(发送)。

    Gemini 会将代码文件中的代码用作提示的引用,并在响应中提供代码的解释。

重置聊天记录

在回答你的问题时,Gemini Code Assist 会使用聊天记录提供更多上下文。

如果你的聊天记录不再与你要尝试达成的目的有关,你可以重置聊天记录:在 Gemini Code Assist 窗格中,点击删除 重置对话

根据提示生成代码

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

在代码文件中提示 Gemini Code Assist

  1. 在代码文件中,另起一行输入注释 Function to create a Cloud Storage bucket,然后按 Enter 键(适用于 Windows 和 Linux)或 Return 键(适用于 macOS)。

  2. 如需生成代码,请按 Alt+Shift+\(适用于 Windows 和 Linux)或 Option+Shift+\ (macOS)。或者,在代码文件的间距区域,点击 spark Gemini Code Assist

    Cloud Code 中的边线显示了“Generate Code with Gemini”(使用 Gemini 生成代码)图标。

    Gemini Code Assist 会在代码文件中的提示文本旁边生成幽灵文本形式的代码。

  3. 可选:如需接受生成的代码,请按 Tab。 如果您希望接受生成的一行代码,请按 Shift+Enter

可选:更改用于生成代码的键盘快捷键

如果用于生成代码的默认键盘快捷键不起作用(如上一部分中所述),您可以按照以下步骤更改该键盘快捷键:

  1. 在 IDE 中,点击 File(适用于 Windows 和 Linux)或 IntelliJ IDEA(适用于 macOS),然后依次转到 Settings > Keymap > Plugins > Google Cloud Code

  2. 在键盘快捷键列表中,滚动至生成代码

  3. 右键点击生成代码,然后选择添加键盘快捷键

  4. 键盘快捷键对话框中,双击当前的键盘快捷键,然后输入您自己的快捷键。

  5. 点击 OK(确定)。

  6. 点击 Apply,然后点击 OK

    现在,你可以使用新分配的键盘快捷键通过 Gemini Code Assist 生成代码。

如需详细了解如何在 IDE 中更改快捷键,请参阅配置键盘快捷键

在编码时获取内嵌建议

在您编写代码时,Gemini Code Assist 会提供内嵌代码建议,您可以接受或忽略这些建议。如需试用此功能,请按以下步骤操作:

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

    Gemini 会以幽灵文本的形式提供代码建议。

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

测试其他示例提示

仔细阅读本文档的使用提示生成代码部分,然后尝试以下示例提示。

Gemini Code Assist 聊天窗格中,输入以下任一提示:

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

已知问题

以下部分概述了 Gemini Code Assist 的已知问题。

如果 Chat 回复包含大型打开文件的更新版本,则可能会被截断

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

IdeaVim:按 Esc 来关闭 IntelliJ 的建议时,插件不显示 Gemini Code Assist 建议

在 IntelliJ 中使用 IdeaVim 插件时,如果按 Esc 关闭 IntelliJ 的建议,会进入 VIM 命令模式,并且不会显示 Gemini Code Assist 建议。

Gemini Code Assist 在插入模式下会按预期运行。

IdeaVim:除非处于插入模式,否则无法接受代码生成建议

在普通模式下使用 IdeaVim 插件时,不能接受代码建议。

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

若要关闭建议,请按 Esc 键。

提供反馈

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

  1. 在状态栏中,点击 Gemini Code Assist,然后在菜单中选择提交反馈

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

  3. 如果您想分享 Gemini Code Assist 日志,请务必选择日志选项。

  4. 点击提交反馈

后续步骤