Firebase Studio 弃用和项目迁移

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，这是我们的下一代 IDE，专为高速、自主的本地工作流而设计。

  • 对于快速的基于浏览器的原型设计：我们将 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。这是我们的下一代 IDE，专为高速、自主的本地工作流而设计。如果您符合以下任一条件，则应选择 Antigravity：

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

迁移到 Google AI Studio

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

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

将应用迁移到 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 同步功能：

  1. 保护 Gemini API 密钥的安全：

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

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

  2. 从 Google AI Studio 同步到 GitHub：

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

    3. 点击 Create GitHub repository。

    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. 点击导入，然后点击发布。

将应用迁移到 Antigravity

Antigravity 是一款本地的智能体优先 IDE，可将 AI 的强大功能引入本地开发环境。

前提条件

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

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

自动迁移

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

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

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

    • 如果您看到压缩并下载按钮，请点击该按钮。
    • 否则，请打开命令面板（在 Mac 上按 Cmd+Shift+P，在 ChromeOS、Windows 或 Linux 上按 Ctrl+Shift+P），然后运行 Firebase Studio：压缩并下载命令。

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

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

    @fbs-to-agy-export

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

手动导出

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

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

npx firebase-tools@latest studio:export PATH

第 2 步：预览应用

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

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

第 3 步：发布应用

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

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

    Publish my app

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

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

将应用迁移到其他平台

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

第 1 步：导出项目源

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

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

第 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 在本地开发和测试应用，以便在不部署到实际环境的情况下更快地进行离线测试。

问题排查和常见问题解答

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

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

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

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

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

以下是创建包含您的历史记录的 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：压缩并下载命令。

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

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

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

如果您的应用使用 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 终端中失败？

如果您在 Antigravity 内遇到“找不到命令”错误或运行 npx 命令时遇到问题（即使这些命令在标准系统终端中可以正常运行），这很可能是由于 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。

其他资源

需要帮助？

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