下载与基础导航
根据 Google 官方 Getting Started 文档梳理 Antigravity 下载入口、平台要求、更新机制，以及 Editor 与 Agent Manager 的基础切换方式。
安装 Antigravity 不难，真正容易出错的是两个地方：系统环境不满足官方最低要求，或者装完以后分不清 Editor 和 Agent Manager 的切换关系。Google 官方 Getting Started 文档很短，本篇把它补成一条可执行的第一步路径。
这一篇解决什么问题：确认你应该从哪里下载、当前系统是否适合安装、更新应该怎么处理，以及第一次进入产品后如何在 Editor 和 Agent Manager 之间来回切换。
阅读目标：读完本章，你应该能独立完成官方下载安装前检查、第一次打开测试 workspace，并用只读 prompt 验证基础工作面。
1. 从官方下载入口开始
官方下载入口是：
https://antigravity.google/download不要从镜像站、网盘包、第三方“汉化包”或别人转发的安装器开始。Antigravity 是本地开发工具，会接触代码、终端和浏览器；安装包来源必须干净。
安装前先做三件事：
- 确认操作系统满足官方最低要求。
- 关闭旧安装器或旧版本残留进程。
- 准备一个干净测试 workspace，不要第一次就打开生产仓。
不要把下载页面上的实时信息写死：版本号、安装包名称、可用平台会更新。教程里固定的是官方入口和判断方法，不固定某一天的包名。
2. 官方平台要求
官方 Getting Started 文档列出的可用平台和最低要求如下。
| 平台 | 官方要求 | 实操判断 |
|---|---|---|
| macOS | Apple 仍提供安全更新的 macOS 版本；通常是当前和前两个版本；最低 macOS 12 Monterey；不支持 x86 | Apple Silicon Mac 优先；Intel Mac 不要默认假设可用 |
| Windows | Windows 10 64-bit | 确认系统是 64 位，并准备常规开发工具链 |
| Linux | glibc >= 2.28，glibcxx >= 3.4.25，例如 Ubuntu 20、Debian 10、Fedora 36、RHEL 8 | 先查发行版和 glibc 版本，再装 |
Linux 用户可以先查：
ldd --version
strings /usr/lib*/libstdc++.so.6 2>/dev/null | rg 'GLIBCXX_3\\.4'如果你不确定机器是否满足要求，不要直接用真实项目测试。先安装到独立环境，打开空目录，确认启动、登录和基础导航都正常。
3. 第一次安装后的更新处理
官方文档说明：应用有可用更新时会提示用户。也就是说，Antigravity 不是“装完一个固定版本长期不动”的工具。
建议建立下面的更新习惯：
- 普通学习环境：跟随自动更新。
- 生产项目环境：更新后先用测试 workspace 验证。
- 录课或写教程时：标注验证日期，不把 UI 截图当永久事实。
- 需要停留旧版本时：后续去 Releases 页面查旧版本，但默认不推荐长期固定旧版本。
AI 编程工具迭代很快。模型、权限项、设置页和 UI 位置都可能变。遇到教程截图和本机不同，先以官方当前 UI 为准。
4. 先理解两个入口：Editor 和 Agent Manager
Antigravity 有两个第一天就会遇到的核心界面：
| 界面 | 你在这里做什么 |
|---|---|
| Editor | 打开一个 workspace，读写代码、看文件、用 Tab / Command / Agent |
| Agent Manager | 管理多个 workspace 和多个 agent 任务，查看 conversation 与 artifacts |
官方 Getting Started 文档给出的基础导航是：
- 从 Editor 顶部按钮打开 Agent Manager。
- 从 Editor 用快捷键
Cmd + E（Mac）/Ctrl + E（Windows）打开 Agent Manager。 - 在 Agent Manager 中，从 workspace 下拉菜单的 Focus Editor 打开对应 Editor。
- 当聚焦某个 workspace 时，可以用 Open Editor 按钮或
Cmd + E（Mac）/Ctrl + E（Windows）打开 Editor。
教程要记的是逻辑：Editor 负责单 workspace 的代码现场，Agent Manager 负责跨 workspace 的任务管理。
flowchart LR
Editor["Editor<br/>单个 workspace"] -->|Top bar / Cmd+E (Mac) · Ctrl+E (Win)| Manager["Agent Manager<br/>任务与 artifacts"]
Manager -->|Focus Editor| Editor
Manager -->|Open Editor| Editor
style Editor fill:#dbeafe,stroke:#3b82f6,stroke-width:2px
style Manager fill:#fef3c7,stroke:#f59e0b,stroke-width:2px深读：为什么第一次不要直接打开生产仓
Antigravity 是本地 agentic development platform，它会围绕 workspace、terminal、browser 和 artifacts 工作。第一次启动时，你还不知道当前账号、权限、快捷键、更新状态和 agent 默认行为是否符合预期。
用空测试目录启动，可以把变量压到最小：只验证安装来源、系统兼容、Editor 与 Agent Manager 导航、只读 prompt 约束是否生效。确认这些基础面正常后，再打开真实项目会稳得多。
5. 第一次打开应该怎么走
第一次启动后，不要马上接真实项目。建议按这个顺序：
- 打开一个空测试目录。
- 在 Editor 里确认文件区、终端区和 agent 面板都能显示。
- 用顶部按钮或
Cmd + E（Mac）/Ctrl + E（Windows）打开 Agent Manager。 - 从 Agent Manager 里找到当前 workspace。
- 用 Focus Editor 或 Open Editor 回到 Editor。
- 只读让 agent 解释当前目录，不允许改文件。
第一条 prompt 可以这样写：
请只读分析当前 workspace，不要创建、修改或删除任何文件。
请说明：
1. 你现在能看到哪些文件或目录。
2. 你判断这是一个什么项目。
3. 如果下一步要修改，应该先改哪个最小文件。
4. 你需要哪些权限才能继续。这条 prompt 的目的不是得到多聪明的答案，而是确认 Antigravity 的基础工作面正常：能读 workspace、能响应限制、不会越权动文件。
6. 用导航关系判断任务应该放哪里
分不清入口时，用下面的规则：
| 任务 | 更适合入口 |
|---|---|
| 改当前文件、看 diff、处理局部错误 | Editor |
| 同时管理多个仓库或多个 agent | Agent Manager |
| 追踪一个长任务的计划和产物 | Agent Manager |
| 看 browser screenshot、recording、walkthrough | Agent Manager 或相关 artifact |
| 手动审查代码细节 | Editor |
一句话：写代码回 Editor，看任务和证据回 Agent Manager。
7. 安装完成后的验收清单
安装不以“图标能打开”为结束，至少验证下面几项：
- 下载来自
antigravity.google/download。 - 当前系统满足官方平台要求。
- 应用能启动并完成登录或进入可用状态。
- 能打开测试 workspace。
- 能从 Editor 切到 Agent Manager。
- 能从 Agent Manager 回到对应 Editor。
- 能完成一条只读 prompt，且没有修改文件。
这些都通过后，再继续学习 Agent、权限、rules、skills、Browser Agent 和 artifacts。
本章自检
完成本章后，用这 3 个问题检查自己是否真正理解：
- 为什么安装包必须来自
antigravity.google/download？ - Editor 和 Agent Manager 之间应该怎样来回切换？
- 第一条只读 prompt 要验证哪些基础能力？
通过标准：你能在不接触生产仓的情况下完成下载安装、基础导航和只读工作面验证。
官方来源
- Google Antigravity Getting Started —— 官方安装、平台要求、更新和基础导航说明。
- Google Antigravity Download —— 官方下载入口，避免使用第三方安装包。
- Google Antigravity Releases —— 官方旧版本和发布信息入口，用于核对版本变化。