Firebase Studio 弃用和项目迁移

自 2026 年 6 月 22 日起， Firebase Studio 将停用创建新工作区和注册新用户的功能。

在弃用日期（2027 年 3 月 22 日）之前，您可以继续 在现有 Firebase Studio工作区中处理项目。 但是，对于您希望在该弃用日期之后继续维护的任何项目， 您必须在 2027 年 3 月 22 日之前按照本页上的说明迁移这些项目。

Firebase Studio 将于 2027 年 3 月 22 日弃用。 我们将从 Firebase Studio 预览版中获得的经验教训融入到我们的以下旗舰工具中，从而简化我们的 AI 开发者产品： Google AI Studio 和 Google Antigravity。

虽然用于构建应用的界面在不断发展，但我们对 Firebase 生态系统的承诺却比以往任何时候都更加坚定。通过将智能体功能直接集成到我们的旗舰 AI 平台中，我们可确保 Firebase 继续为 AI 驱动型开发提供顺畅可靠的后端。Cloud Firestore、Authentication 和 App Hosting 等核心 Firebase 服务将继续在 Firebase Studio 之外运行。

我们为什么进行这项更改

Firebase Studio 以预览版形式推出，旨在探索 AI 驱动型全栈开发的未来。根据您的反馈，我们正在简化工具，以便为您提供更清晰、更强大的前进方向：

• 对于代码优先的智能体开发：我们专注于 Antigravity，这是我们的下一代平台，专为高速、 自主的多智能体工作流而设计。

• 对于快速的基于浏览器的原型设计：我们将 Cloud Firestore 和 Firebase Authentication 直接集成到 Google AI Studio 中，以提供从提示到生产环境的最快路径。

您的核心 Firebase 服务（Cloud Firestore、Authentication、App Hosting 等）不会受到影响。您的数据库和用户数据将继续正常运行。此弃用仅适用于 Firebase Studio 开发环境。

弃用时间轴

我们提供了一年的过渡期，以确保您有充足的时间迁移项目：

• 2026 年 3 月 19 日：发布弃用公告，并开始向 Firebase Studio 推出迁移工具。
• 2026 年 6 月 22 日：停用创建新工作区和注册新用户的功能。您可以继续在现有工作区中工作并迁移这些工作区。
• 2027 年 3 月 22 日：Firebase Studio 将关闭，所有 剩余数据将永久删除，无法恢复。

选择迁移路径

根据您使用 Firebase Studio 的方式，选择最适合您工作流的迁移路径。

迁移到 Google Antigravity

如需体验代码优先的智能体开发，我们建议您 迁移到 Antigravity。这是我们的下一代智能体优先平台，专为高速、自主的工作流和多智能体编排而设计。如果您符合以下任一条件，则应选择 Antigravity

• 喜欢在智能体优先的桌面环境中工作，以便使用 Antigravity IDE 或终端更深入地控制代码库
• 在 Firebase Studio 中使用内置模板或导入的代码库创建了应用
• 主要在 Firebase Studio 中使用代码视图环境
• 希望在功能强大的智能体中心内直接使用前沿智能体 AI 开发功能，除了 Gemini 之外，还支持使用 Claude 和 GPT-OSS 等不同模型
• 以 Prototyper 模式启动，但添加了需要本地环境且不受云 限制的重要 功能或执行脚本

迁移到 Google AI Studio

如需体验基于 Web 的原型设计环境，将 AI 的强大功能引入 浏览器，我们建议您迁移到Google AI Studio。它 提供了从提示到全栈生产应用的最快路径。如果您 符合以下任一条件，则应选择 Google AI Studio：

• 偏好基于 Web 的体验，这非常适合多设备工作流或无法安装本地软件的环境
• 使用 App Prototyping agent 在 Firebase Studio 中创建了应用，并且重视快速原型设计和基于提示的应用生成
• 想要以最快的方式从提示生成全栈生产应用

注意 ：如果您最初选择从 Google AI Studio 开始，则可以在稍后阶段迁移 到 Google Antigravity，方法是切换到 Google AI Studio 中的代码 标签页 > 导出 > 导出到 Antigravity。

将应用迁移到 Google AI Studio

Google AI Studio 提供了从提示到全栈生产 应用的最快路径。

第 1 步：转移工作区

1. 点击工作区顶部的立即迁移 按钮，然后选择为 AI Studio 做好准备 。
2. 准备步骤完成后，点击 迁移到 Google AI Studio。
3. 如果系统要求您查看并接受服务条款，请按照提示操作。您的代码将 自动在新 Google AI Studio 工作区中打开。

Google AI Studio 可能需要几分钟时间来转换和加载 应用。完成后，它会通知您。完成后，您可以在 Google AI Studio 智能体的帮助下继续迭代应用。详细了解如何在 Google AI Studio中构建应用。

第 2 步：选择发布方法

根据您的部署需求以及是否要保留现有应用网址，选择以下发布方法之一。

选项 A：发布到 App Hosting 并保留现有网址

如果您之前通过 Firebase Studio 发布了应用，并且想要 保留 *.hosted.app 网址或自定义网域，请保护 Gemini API 密钥并 使用 GitHub 同步：

注意： 当您使用 Firebase Studio 将应用发布到 App Hosting 时， Firebase Studio 会自动从您的 工作区 .env 文件中提取 Gemini API 密钥，并将其配置为 App Hosting 环境 变量，您的应用可以访问该变量，但您的用户无法访问。迁移到 Google AI Studio时，您必须在 Firebase控制台中手动设置环境变量，才能通过 GitHub 同步继续发布到 App Hosting（因为 .env 文件不应存储在 GitHub 中，以避免 API 密钥 泄露）。虽然此方法可以安全地存储密钥，但任何有权访问您的 Firebase 项目的人都可以访问该密钥。如果您需要更 精细的访问权限控制，请考虑将密钥存储在 Secret Manager 中，而不是

。

1. 保护 Gemini API 密钥：

   1. 在 Firebase 控制台中，前往 App Hosting 页面。
   2. 找到现有后端（通常名为 studio），然后点击查看 。
   3. 在设置 标签页中，前往环境 。

   4. 点击添加新项 ，然后将 .env 文件的内容粘贴到密钥 字段中，以安全地将 Gemini API 密钥存储为环境变量。

      提示： 您可以通过在 Firebase Studio中切换到代码模式来查找您的.env文件。

2. 从 Google AI Studio 同步到 GitHub：

   1. 在 Google AI Studio 中，点击 设置 图标，然后前往 GitHub 面板。
   2. 点击 Sign in to GitHub ，然后安装 Google AI Studio GitHub 应用。

   3. 点击 Create GitHub repository 。

      **重要提示** ：查看文件列表，并确认其中不包含 .env。

   4. 选择暂存并提交所有更改 。

3. 将代码库连接到 App Hosting：

   1. 在 Firebase 控制台中，前往 App Hosting 页面。
   2. 找到现有后端（通常名为 studio），然后点击查看 。
   3. 在设置 标签页中，依次选择部署 > 连接到 GitHub 。
   4. 登录 GitHub 并安装 Firebase App Hosting GitHub 应用。
   5. 选择您的代码库，将分支设置为 main，并将根目录 设置为 /。
   6. 点击保存并部署 。

4. 将更改同步到 GitHub 并进行部署：

   1. 在 Google AI Studio 中，前往 GitHub 面板。
   2. 查看要发布的更改。
   3. 点击暂存并提交所有更改 。
   4. 前往 Firebase 控制台 监控 App Hosting 部署的进度。

选项 B：迁移到 Cloud Run 并将应用发布到新网址

如果您偏好一键式体验，并且之前未发布 应用，或者不介意使用新网址 (*.run.app)，请使用发布按钮： Google AI Studio

1. 在 Google AI Studio 中打开应用，然后点击 发布。
2. 在项目选择器中，点击导入项目 。
3. 搜索并选择 Firebase Studio 使用的项目名称（可在 您的 Firebase Studio 工作区的顶部导航栏中找到）。
4. 点击导入，然后点击发布。

注意： 如果您有自定义网域，则必须将其映射到新的 Cloud Run服务。网域映射最多可能需要 24 小时，并且可能会 导致应用停机。或者，您可以继续发布到 Firebase App Hosting，使用 AI Studio 中的 GitHub 同步来避免迁移网域。

将应用迁移到 Antigravity

Antigravity 是一个本地的智能体优先平台和智能体中心，可将 自主多智能体工作流的强大功能引入本地开发 环境。

前提条件

请确保以下软件已在本地安装并保持最新状态：

• Google Antigravity IDE： 从下载选项中，选择 Antigravity IDE （编辑器环境）。 这是代码优先的工作区，您将在其中打开和运行迁移后的应用。
• Node.js（版本 20 或更高版本）
• Firebase CLI（版本 15.10.0 或更高版本）

第 1 步：导出并初始化应用

自动迁移

此工作流使用 Antigravity 智能体自主处理项目 转换。

1. 在 Firebase Studio 中，点击您的 工作区顶部的立即迁移 按钮。

2. 根据显示的窗口，按照相应的导出方法操作：

   • 如果您看到压缩并下载按钮，请点击该按钮。
   • 否则，请打开命令面板（在 Mac 上按 Cmd+Shift+P，在 ChromeOS、Windows 或 Linux 上按 Ctrl+Shift+P），然后运行 Firebase Studio：压缩并下载命令。
   提示： 如果下载窗口未显示，请检查浏览器的地址 栏中是否有弹出式窗口拦截器图标，并确保允许弹出式窗口。

3. 将文件夹提取到本地，然后在 Antigravity IDE 中打开该文件夹。

4. 在 Antigravity IDE 界面内的 智能体 窗格中，输入 以下提示。 为了优化工作流并节省 token，我们建议选择 Gemini Flash 模型。它专为大批量转换任务（例如文件转换）而设计，可实现快速高效的转换。

   @fbs-to-agy-export
   

5. Antigravity 智能体将开始项目迁移，并在迁移过程中请求您的 协助。按照智能体的指导完成迁移流程。如果您遇到任何错误，请提示智能体重试。

手动导出

如果您不想使用 AI Token，而是想自行管理迁移，可以使用 Firebase CLI 手动导出项目。此方法是直接的，不需要与智能体互动。

打开终端并运行以下命令，将 PATH 替换为解压缩后的项目文件夹或原始 ZIP 文件的路径（如果您已位于目标目录中，请使用 .）：

npx firebase-tools@latest studio:export PATH

注意 ：studio:export 命令已针对 Next.js、Flutter 和 Angular 工作区进行了优化。虽然您可以将此命令用于其他工作区类型， 但迁移可能不会更新所有代码制品以供 Antigravity 使用。 我们正在积极改进迁移流程。

第 2 步：预览应用

提取项目并在 Antigravity IDE 中打开后， 您可以在本地查看应用：

1. 在 Antigravity IDE 中，前往位于左侧边栏中的运行和调试 菜单 。
2. 点击“播放”按钮以启动本地开发服务器。
3. 按照终端中的说明预览应用。

提示： 如需优化应用或排查问题，请在智能体窗格中使用 自然语言与智能体对话。如果智能体窗格处于隐藏状态，请点击窗口顶部的切换智能体 图标以重新打开它。

第 3 步：发布应用

Antigravity 使用智能体技能，按照 Firebase 最佳 实践发布您的应用。

1. 在智能体对话面板中，输入以下提示：

   Publish my app
   

2. 当系统提示运行 firebase deploy 时，选择是 。如果您之前已发布到 Firebase App Hosting，则智能体将发布到现有网址。如果您是首次向 App Hosting发布内容，智能体会引导您完成相应流程。

3. 如需了解未来的更新，请指示智能体在对话面板中执行 publish my app 操作。

将应用迁移到其他平台

如果您希望将项目迁移到其他开发环境或托管平台，可以导出源代码并手动管理部署。

第 1 步：导出项目源

在弃用日期之前，您必须下载项目文件的本地副本：

1. 依次点击工作区顶部的立即迁移按钮 > 压缩并下载。
2. 将归档文件解压缩到本地机器。

提示：您还可以将工作区导出到 GitHub。如需了解详情，请参阅将应用上传到 GitHub。

第 2 步：选择发布方法

将代码移至本地后，您可以使用以下方法继续提供应用：

• Firebase CLI（保留现有网址）

  1. 运行以下命令，使用 npm 安装 Firebase CLI：

     npm install -g firebase-tools
     

  2. 在终端中，导航到您的项目目录。

  3. 运行以下命令，为本地项目设置 App Hosting 部署：

     firebase init apphosting
     

  4. 在系统提示时，选择关联到现有后端，然后选择名为 studio 的后端。这样可确保应用网址保持不变。

  5. 按照提示完成设置。您的 App Hosting 配置将添加到 firebase.json 中。

  6. 部署应用：

     firebase deploy
     

• 外部托管：由于导出的代码是标准 Web 应用，因此您可以使用任何托管服务提供商对其进行初始化。请注意，迁移到外部服务提供商将会产生一个新的网址。

• 仅限本地开发：您可以继续使用 Firebase Local Emulator Suite 在本地开发和测试应用，以便在不部署到实际环境的情况下更快地进行离线测试。

注意：无论您选择哪个平台进行托管，Cloud Firestore 和 Authentication 等核心 Firebase 服务都将继续正常运行。

问题排查和常见问题解答

请查看以下常见问题和问题排查步骤，了解如何迁移 Firebase Studio 项目。

在弃用之前，我可以继续使用 Firebase Studio 吗？

可以，您可以在 2027 年 3 月 22 日之前访问现有工作区。我们将继续提供关键安全补丁和 Gemini 模型更新，以确保您当前的项目保持稳定。请注意，从 2026 年 6 月 22 日起，系统将停用创建新工作区功能。

重要提示：您必须在 2027 年 3 月 22 日之前迁移项目。在该日期，Firebase Studio 将关闭，所有剩余数据都将永久删除，无法恢复。

我的智能体对话记录会迁移吗？

智能体对话记录不包含在当前导出的 ZIP 文件中。不过， 您可以在 工作区内 App Prototyping agent 和 Gemini 智能体的对话记录文件，这些文件位于 您的 Firebase Studio 工作区的 /home/user/.idx/ai 目录中。此文件包含所有对话模式下的提示和回答。

以下是创建包含您的历史记录的 ZIP 文件的方法：

1. 选择文件 > 打开文件夹。
2. 接受默认的 /home/user 目录。
3. 文件加载后，右键点击 .idx/ai 目录，然后选择压缩并下载。
4. 当系统提示您重新构建环境时，点击取消。
5. 下载完成后，从文件 菜单重新打开工作目录，以返回工作区。

对于 Prototyper 会话，您还可以将提示作为 git 日志的一部分查看。以下说明了如何找到这些提示：

1. 打开代码视图 ()。

2. 执行以下任一操作：

   • 打开终端会话（在 Mac 上按 Cmd-Shift-C，在 ChromeOS、Windows 或 Linux 上按 Ctrl-Shift-C），然后输入 git log。
   • 打开源代码控制（在 Mac 上按 Cmd+Shift+G，在 ChromeOS、Windows 或 Linux 上按 Ctrl-Shift+G），然后查看源代码历史记录。

我尝试在 Firebase Studio 中压缩并下载文件，但没有任何反应。

这通常是由浏览器弹出式窗口拦截器造成的。由于迁移流程会打开一个新界面来处理您的请求，因此某些浏览器可能会将其标记为不需要的弹出式窗口。

如需解决此问题，请在浏览器的地址栏（通常位于右侧）中查找“已拦截弹出式窗口”通知。点击该图标，然后选择允许弹出式窗口的选项，接着再次尝试点击该按钮。

如果此方法不起作用，请按照如何从 下载文件Firebase Studio？中的说明手动运行压缩并下载 命令。

我可以迁移与我共享的 Firebase Studio 工作区吗？

只有 Firebase Studio 工作区的创建者才能使用立即迁移按钮。如果您想要项目副本，可以执行以下任一操作：

• 复制工作区：在您自己的账号下创建项目的副本，以便您将其关联到自己的 Firebase 项目并使用迁移工具。
• 手动导出代码：在代码视图中，您可以打开命令面板（在 Mac 上按 Cmd+Shift+P，在 ChromeOS、Windows 或 Linux 上按 Ctrl+Shift+P），然后运行 Firebase Studio：压缩并下载命令。

重要提示：如果您选择从共享工作区手动导出代码，请注意后端配置（例如 Firebase 项目和 API 密钥）仍会指向原始所有者的资源。您需要创建一个新的 Firebase 项目并更新环境变量，以确保应用在您自己的账号下运行。

在哪里可以找到我已迁移到 Google AI Studio 的应用？

您的应用页面提供 了一个统一的列表，其中列出了您的所有项目，包括在 Google AI Studio中从头开始创建的项目以及您已迁移的所有项目。

Firebase Authentication 无法在迁移到 Google AI Studio 后使用 Google 登录正常运行。

如果您的应用使用 Google 登录，则必须授权新的项目网域。

1. 在 Firebase 控制台中，前往 Authentication 设置页面。
2. 点击授权的网域 。
3. 点击添加网域 ，然后添加您的Google AI Studio 应用的网域。

如果 Google AI Studio 智能体停止运行，或者我在迁移后在 Google AI Studio 中看到错误，该怎么办？

由于 Google AI Studio 智能体在迁移应用时会管理复杂的后台任务，因此智能体有时可能会遇到“任务已取消”、重复消息或无响应的线程等问题。

• 如果智能体在任务中途停止，但没有明确的错误，则向其提供“从上次中断的地方继续”或“再次尝试上一步”等提示通常可以启动该流程。
• 如果您看到一条消息，指出运行代码时出现错误，请点击修复 按钮，提示智能体自动解决这些错误。

如果导出停滞或超时，该怎么办？

如果迁移过程在准备文件时挂起，通常是因为项目文件夹过大。

为成功迁移做好准备：

• 删除 node_modules：在迁移过程中，系统通常会移除此文件夹。不过，如果您重命名或移动了该文件夹，或者打算手动压缩并下载代码，请在开始迁移之前将其删除。您无需迁移此文件夹，因为在迁移到新环境后，您可以运行 npm install。
• 移除大型制品：删除任何并非源代码绝对必要的大型媒体文件、数据库导出内容或 build 文件夹。
• 检查是否存在“隐藏”的冗余文件：确保您没有意外压缩庞大的 .git 历史记录或本地日志。

删除所有大型文件后，再次尝试迁移项目。

为什么我的 Firebase CLI 或 npx 命令在 Antigravity 终端中失败？

如果您在遇到“找不到命令”错误或运行 npx 命令 在 Antigravity 内遇到问题（即使这些命令在标准系统 终端中可以正常运行），这很可能是由于 shell 环境的初始化方式所致。

Antigravity 的终端环境会在 ~/.bash_profile 中查找配置设置。许多开发者将 npx 和路径配置存储在 ~/.bashrc 中。如果不分享这些设置，Antigravity 将不知道在哪里查找您的工具。

您可以在 .bash_profile 中加载 .bashrc 文件来解决此问题。这样可确保在每次启动 Antigravity时加载所有现有配置。

1. 在 Antigravity 中打开您的 ~/.bash_profile 文件。

2. 在文件中添加以下代码块。

   if [ -f ~/.bashrc ]; then
       source ~/.bashrc
   fi
   

3. 保存文件。

4. 重启 Antigravity。

其他资源

• 试用 Firebase Studio 到 Antigravity 迁移 Codelab。
• 探索 Antigravity 文档。
• 探索 Google AI Studio 文档。

需要帮助？

如果您在迁移项目时有任何疑问、反馈或遇到任何问题，请通过以下渠道之一与我们联系：

• 与 Firebase 支持团队联系。
• 请在 Firebase Studio 社区论坛中发帖。