---
title: "下载与基础导航"
description: "根据 Google 官方 Getting Started 文档梳理 Antigravity 下载入口、平台要求、更新机制，以及 Editor 与 Agent Manager 的基础切换方式。"
verifiedAt: "2026-05-06"
---

安装 Antigravity 不难，真正容易出错的是两个地方：系统环境不满足官方最低要求，或者装完以后分不清 Editor 和 Agent Manager 的切换关系。Google 官方 Getting Started 文档很短，本篇把它补成一条可执行的第一步路径。

> [!NOTE]
> **这一篇解决什么问题**：确认你应该从哪里下载、当前系统是否适合安装、更新应该怎么处理，以及第一次进入产品后如何在 Editor 和 Agent Manager 之间来回切换。

> [!TIP]
> **阅读目标**：读完本章，你应该能独立完成官方下载安装前检查、第一次打开测试 workspace，并用只读 prompt 验证基础工作面。

## 1. 从官方下载入口开始

官方下载入口是：

```text
https://antigravity.google/download
```

不要从镜像站、网盘包、第三方“汉化包”或别人转发的安装器开始。Antigravity 是本地开发工具，会接触代码、终端和浏览器；安装包来源必须干净。

安装前先做三件事：

1. 确认操作系统满足官方最低要求。
2. 关闭旧安装器或旧版本残留进程。
3. 准备一个干净测试 workspace，不要第一次就打开生产仓。

> [!IMPORTANT]
> **不要把下载页面上的实时信息写死**：版本号、安装包名称、可用平台会更新。教程里固定的是官方入口和判断方法，不固定某一天的包名。

## 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 用户可以先查：

```bash
ldd --version
strings /usr/lib*/libstdc++.so.6 2>/dev/null | rg 'GLIBCXX_3\\.4'
```

如果你不确定机器是否满足要求，不要直接用真实项目测试。先安装到独立环境，打开空目录，确认启动、登录和基础导航都正常。

## 3. 第一次安装后的更新处理

官方文档说明：应用有可用更新时会提示用户。也就是说，Antigravity 不是“装完一个固定版本长期不动”的工具。

建议建立下面的更新习惯：

- 普通学习环境：跟随自动更新。
- 生产项目环境：更新后先用测试 workspace 验证。
- 录课或写教程时：标注验证日期，不把 UI 截图当永久事实。
- 需要停留旧版本时：后续去 Releases 页面查旧版本，但默认不推荐长期固定旧版本。

> [!WARNING]
> 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 的任务管理。

```mermaid
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
```

<details>
<summary>深读：为什么第一次不要直接打开生产仓</summary>

Antigravity 是本地 agentic development platform，它会围绕 workspace、terminal、browser 和 artifacts 工作。第一次启动时，你还不知道当前账号、权限、快捷键、更新状态和 agent 默认行为是否符合预期。

用空测试目录启动，可以把变量压到最小：只验证安装来源、系统兼容、Editor 与 Agent Manager 导航、只读 prompt 约束是否生效。确认这些基础面正常后，再打开真实项目会稳得多。
</details>

## 5. 第一次打开应该怎么走

第一次启动后，不要马上接真实项目。建议按这个顺序：

1. 打开一个空测试目录。
2. 在 Editor 里确认文件区、终端区和 agent 面板都能显示。
3. 用顶部按钮或 `Cmd + E`（Mac）/ `Ctrl + E`（Windows）打开 Agent Manager。
4. 从 Agent Manager 里找到当前 workspace。
5. 用 **Focus Editor** 或 **Open Editor** 回到 Editor。
6. 只读让 agent 解释当前目录，不允许改文件。

第一条 prompt 可以这样写：

```text
请只读分析当前 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 个问题检查自己是否真正理解：

1. 为什么安装包必须来自 `antigravity.google/download`？
2. Editor 和 Agent Manager 之间应该怎样来回切换？
3. 第一条只读 prompt 要验证哪些基础能力？

通过标准：你能在不接触生产仓的情况下完成下载安装、基础导航和只读工作面验证。

## 官方来源

- [Google Antigravity Getting Started](https://antigravity.google/docs/get-started) —— 官方安装、平台要求、更新和基础导航说明。
- [Google Antigravity Download](https://antigravity.google/download) —— 官方下载入口，避免使用第三方安装包。
- [Google Antigravity Releases](https://antigravity.google/releases) —— 官方旧版本和发布信息入口，用于核对版本变化。

## 接下来去哪

<Cards>
  <Card title="Antigravity 是什么" description="如果还没建立产品心智模型，先回到官方概览。" href="/docs/antigravity/official/00-getting-started/00-product-overview" />
  <Card title="第一次安全运行" description="安装完成后，按只读、小改、浏览器验收的顺序跑第一天闭环。" href="/docs/antigravity/understanding/02-install-first-safe-run" />
</Cards>
