Firebase Studio 通过以下 AI 辅助型代码功能简化了开发工作流程：
在您输入时提供代码补全建议。
聊天式 AI 辅助功能，可感知工作区并与您的代码完全集成。它可以生成、翻译和解释代码。经过您的审核和批准，Firebase 中的 Gemini 可以直接与您的工作区交互，以更新文件、运行终端命令、解读命令输出并确定后续步骤。如需了解详情，请参阅试用 Gemini 聊天功能。
您可以对所选代码段执行的直接操作。例如，您可以让 Gemini 提高所选代码的可读性。
内嵌代码协助。
您可以通过调整 Firebase 中的 Gemini 设置和添加 AI 规则文件来自定义 Gemini 为您提供的帮助方式：
- 调整代码补全设置。
- 调整代码库编入索引设置。
- 使用 AI 规则文件自定义 Gemini 的说明。
- 使用
.aiexclude文件从 Gemini 中排除文件。 - 自带密钥：在聊天中使用其他 Gemini 模型
在 Workspace 中使用 Firebase 中的 Gemini
在 Firebase 中使用 Gemini，通过聊天面板或内嵌代码助理提高编码效率。
在 Workspace 中使用聊天或内嵌代码辅助功能：
如需使用聊天功能，请在打开的工作区中，点击工作区底部的火花图标 Gemini。
如需使用内嵌代码协助功能，请开始输入代码，然后按
Tab接受建议。
请注意，以下两个选项在默认情况下处于启用状态：
- 在输入过程中显示相关建议，可提供内嵌代码补全。
- 代码库索引，可提供更好的自定义功能和更实用的回答。
如需日后更改工作区设置的这些选择，请执行以下操作：
- 如需更新代码补全设置，请参阅调整代码补全设置。
- 如需更新代码编入索引设置，请参阅调整代码编入索引设置。
您还可以将特定文件和目录从 AI 索引中排除。请参阅使用
.aiexclude文件从 Gemini 中排除文件。
Firebase 快捷方式中的 Gemini
如需快速打开与 Gemini 的聊天对话，请按 Ctrl+Shift+Space（在 macOS 上，按 Cmd+Shift+Space）。
如需从命令 Palette 查看 Gemini 命令，请执行以下操作：
按
Ctrl+Shift+P（在 macOS 上，按Cmd+Shift+P）打开命令面板。搜索 Gemini。
系统随即会显示 Gemini 命令列表。
调整代码补全设置
Firebase Studio 提供 AI 代码补全功能，可在您开始输入时，在任何打开的文件中预测和自动填充代码，帮助您编写代码。
请注意，代码补全功能默认处于开启状态。
如需开启或关闭代码补全功能，请使用以下方法之一调整代码补全设置：
如果您使用的是
settings.json文件，请将"IDX.aI.enableInlineCompletion"设置为true或false。如需更新 Firebase Studio 工作区中的设置，请执行以下操作：
点击
管理（位于工作区的左下角），然后选择“设置”，或按 Ctrl+,（在 Mac 上为Cmd+,）。如果您在 Prototyper view, click
Switch to Code to open Code view. 中使用 App Prototyping agent选择 Workspace（工作区）标签页，然后依次选择 Firebase Studio > AI > 启用内嵌补全设置。
如需关闭代码补全功能，请取消选中在您输入时启用内嵌代码补全选项。
调整代码库索引设置
您可以控制 Gemini 是否为您的代码编制索引。 为代码编制索引后，在使用聊天或内嵌 AI 辅助功能时，系统会提供更实用的结果。
请注意，代码库编入索引功能默认处于启用状态。
如需开启或关闭代码编入索引，请使用以下方法之一调整代码库编入索引设置：
如果您使用的是
settings.json文件，请将"IDX.aI.enableCodebaseIndexing"设置为true或false。如需更新 Firebase Studio 工作区中的设置，请执行以下操作：
点击
Manage（位于工作区的左下角），然后选择“Settings”（设置），或按 Ctrl+,（在 Mac 上为Cmd+,）。如果您在 Prototyper view, click
Switch to Code to open Code view. 中使用 App Prototyping agent选择 Workspace（协作空间）标签页，然后依次选择 Firebase Studio > AI > 启用内嵌补全设置。
依次选择 Firebase Studio > AI：启用代码库索引。
如需停用代码索引编制，请取消选中 AI：启用代码库索引编制。 您必须更新每个工作区的代码编入索引设置。
使用 AI 规则文件为 Firebase 中的 Gemini 自定义说明
您可以通过创建 AI 规则文件 (.idx/airules.md) 来添加上下文和系统提示信息。Gemini in Firebase 会将您的规则用作系统指令和上下文，确保其回答能根据您的用例进行自定义。
使用 AI 规则文件与 Gemini 分享自定义提示、最佳实践，甚至项目的重要背景信息，以实现以下目标：
- 影响 Gemini 的角色并专精其专业知识。
- 应用项目级标准，例如编码风格、惯例和技术偏好。
- 提供有关项目的基本背景信息，从而减少您需要在代码或聊天中明确分享的信息量。
您配置的规则会由 Gemini 在聊天中使用。
创建和测试 AI 规则文件
如需创建和测试 AI 规则文件，请执行以下操作：
在 Firebase Studio 工作区中的
.idx/airules.md位置（与dev.nix文件位于同一目录中）创建一个新文件。您可以使用以下任一选项：- 在资源管理器 (
Ctrl+Shift+E) 中，右键点击 .idx，然后选择新建文件。将文件命名为airules.md，然后按 Enter 键。 - 在终端中，使用首选文本编辑器打开
.idx/airules.md。
- 在资源管理器 (
向文件添加内容。您可能需要添加有关 Gemini 应使用的角色的信息（例如“您是一位专家级开发者，也是一位乐于提供帮助的助理，对 Next.js 了如指掌”），编码和对话标准，以及项目背景信息。如需查看 AI 规则文件示例，请参阅以下示例。
保存文件，然后在 Firebase 中打开 Gemini。
如需开始使用 AI 规则，您可以执行以下任一操作：
- 刷新页面以重新构建工作区。重新构建后，Firebase 中的 Gemini 将在 Chat 中使用规则文件。对 AI 规则文件所做的更改应立即反映在聊天中。
- 如果您不想重新构建工作区，可以通过 Chat 向
load airules.md询问 Gemini。如果您在当前会话期间对文件进行了更改，则可能需要重新提示 Gemini 再次加载规则文件。
询问与您的代码相关的问题。Gemini 会使用您在规则文件中添加的信息作为上下文进行响应。
示例
以下是规则文件的基本示例，您可以将其用于使用 Next.js 开发的休闲游戏：
# Persona
You are an expert developer proficient in both front- and back-end development
with a deep understanding of Node.js, Next.js, React, and Tailwind CSS. You
create clear, concise, documented, and readable TypeScript code.
You are very experienced with Google Cloud and Firebase services and how
you might integrate them effectively.
# Coding-specific guidelines
- Prefer TypeScript and its conventions.
- Ensure code is accessible (for example, alt tags in HTML).
- You are an excellent troubleshooter. When analyzing errors, consider them
thoroughly and in context of the code they affect.
- Do not add boilerplate or placeholder code. If valid code requires more
information from the user, ask for it before proceeding.
- After adding dependencies, run `npm i` to install them.
- Enforce browser compatibility. Do not use frameworks/code that are not
supported by the following browsers: Chrome, Safari, Firefox.
- When creating user documentation (README files, user guides), adhere to the
Google developer documentation style guide
(https://developers.google.com/style).
# Overall guidelines
- Assume that the user is a junior developer.
- Always think through problems step-by-step.
# Project context
- This product is a web-based strategy game with a marine life theme.
- Intended audience: casual game players between the ages of 17 and 100.
使用 .aiexclude 文件从 Gemini 中排除文件
您可以通过在项目中添加 .aiexclude 文件来控制代码库中哪些文件应对 Gemini 隐藏。这样，您就可以精细控制与 Gemini 共享的项目上下文。
与 .gitignore 文件非常相似，.aiexclude 文件会跟踪不应与 Gemini 共享的文件，包括聊天体验以及在编辑器中运行的 AI 功能。.aiexclude 文件会对包含它的目录中或下方的文件进行操作。
启用代码库索引后，.aiexclude 涵盖的文件不会被 Gemini 编入索引。此外，.aiexclude 还会通过以下方式影响对已覆盖文件的内嵌帮助：
- 聊天支持：Gemini 无法就
.aiexclude涵盖的文件解答问题或提供建议。 - 代码补全：修改已覆盖的文件时，系统不会提供代码补全建议。
- 内嵌协助：您可以在修改被覆盖的文件时生成新代码，但无法修改现有代码。
其他开发环境（例如 Android Studio）也可能会遵循 .aiexclude 文件。
如何编写 .aiexclude 文件
.aiexclude 文件遵循与 .gitignore 文件相同的语法，但存在以下差异：
- 空的
.aiexclude文件会屏蔽其所在目录及其所有子目录中的所有文件。这与包含**/*的文件相同。 .aiexclude文件不支持否定（为模式添加!前缀）。
示例
以下是一些 .aiexclude 文件配置示例：
屏蔽包含
.aiexclude文件的目录中或下方的所有名为apikeys.txt的文件：apikeys.txt在包含
.aiexclude文件的目录或该目录下，屏蔽所有扩展名为.key的文件：*.key仅屏蔽与
.aiexclude位于同一目录中的apikeys.txt文件，而不屏蔽任何子目录：/apikeys.txt屏蔽
my/sensitive/dir目录及其所有子目录中的所有文件。路径应相对于包含.aiexclude文件的目录：my/sensitive/dir/
自带密钥：在聊天中使用其他 Gemini 模型
您可以配置 Chat 中的 Gemini 使用的 Gemini 模型。Firebase您可以选择内置模型、在聊天窗口中配置的模型（包括 Gemini 2.5 模型），或您有权访问的任何 Gemini 模型。
如需查看所有可用模型的列表，请参阅 Gemini 模型。
如需配置密钥并选择其他 Gemini 模型，请执行以下操作：
在打开的工作区中，点击工作区底部的火花图标 Gemini（或 Gemini 标签页）。
在 Firebase 中的 Gemini 聊天窗口中，点击模型名称下拉菜单，然后点击 Gemini API 键链接。系统随即会显示用户设置。
在 IDX > AI: Gemini Api Key 字段中，输入您的 Gemini API 密钥。
您现在可以在聊天中选择任何预配置的 Gemini 模型。
如需配置下拉菜单中未列出的 Gemini 模型，请执行以下操作：
从 Gemini 模型列表中，找到您要在聊天中使用的 Gemini 模型。例如，您可以输入
gemini-2.0-flash-lite在 Firebase 聊天窗口中的 Gemini 中，点击模型选择器，然后选择自定义模型 ID。系统随即会打开用户设置。
将您选择的模型名称复制到 IDX > AI: Gemini Model 字段。
关闭聊天窗口，然后点击工作区底部的火花图标 Gemini 重新打开该窗口，以刷新模型列表。