我们将于 2027 年 3 月 22 日弃用 Firebase Studio。如需继续构建和部署应用的新版本，请在该日期之前将 Firebase Studio 项目迁移到 Google AI Studio 或 Google Antigravity。了解如何迁移。

即使在弃用日期过后，已部署到 Firebase 的所有应用仍会继续运行。此外，所有核心 Firebase 产品（例如 Firestore、Authentication、App Hosting 等）不会因 Firebase Studio 弃用而受到影响。

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 mode, but added significant features or execution scripts that require a local environment without cloud limitations

迁移到 Google AI Studio（即将推出）

我们仍在完善迁移到 Google AI Studio 的流水线，以确保其可靠运行。如果符合以下任一条件，您应在该功能推出后选择 Google AI Studio：

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

请稍后回来查看 Google AI Studio 的迁移说明！

将应用迁移到 Antigravity

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

前提条件

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

Google Antigravity IDE
Node.js（版本 20 或更高版本）
Firebase CLI（版本 15.10.0 或更高版本）

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

自动迁移

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

在 Firebase Studio 中，点击工作区顶部的立即迁移按钮。
根据显示的窗口，按照相应的导出方法操作：
- 如果您看到压缩并下载按钮，请点击该按钮。
- 否则，请打开命令面板（在 Mac 上按 Cmd+Shift+P，在 ChromeOS、Windows 或 Linux 上按 Ctrl+Shift+P），然后运行 Firebase Studio：压缩并下载命令。
提示：如果下载窗口未显示，请检查浏览器的地址栏中是否有弹出式窗口拦截器图标，并确保允许弹出式窗口。
将文件夹提取到本地，然后在 Antigravity 中打开该文件夹。
在 Antigravity 内的智能体窗格中，输入以下提示。为了优化工作流并节省 token，我们建议选择 Gemini Flash 模型。它专为大批量转换任务（例如文件转换）而设计，可实现快速高效的转换。
```
@fbs-to-agy-export
```
Antigravity 智能体将开始项目迁移，并在迁移过程中请求您的协助。按照智能体的指导完成迁移流程。如果您遇到任何错误，请提示智能体重试。

手动导出

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

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

npx firebase-tools@latest studio:export PATH

第 2 步：预览应用

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

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

第 3 步：发布应用

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

在对话面板中，输入以下提示：
```
Publish my app
```
当系统提示运行 firebase deploy 时，选择是。如果您之前已发布到 Firebase App Hosting，则智能体将发布到现有网址。如果您是首次向 App Hosting 发布内容，智能体会引导您完成相应流程。
如需了解未来的更新，请指示智能体在 Antigravity 对话面板中执行 publish my app 操作。

将应用迁移到其他平台

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

第 1 步：导出项目源

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

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

第 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 文件的方法：

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

对于 Prototyper sessions, you can also view your prompts as part of the git log. Here's how to locate them:

打开代码视图 ()。
执行以下任一操作：
- 打开终端会话（在 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：压缩并下载命令。

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

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

为成功迁移做好准备：

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

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

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

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

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

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

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

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

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

保存文件。
重启 Antigravity。

需要帮助？

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

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