---
title: "Google Antigravity 中文教程"
description: "基于 Google 官方资料重写的 Antigravity 中文教程，覆盖 Agent Manager、Editor、Browser、Artifacts、Rules、Workflows、Skills、MCP 与权限治理。"
verifiedAt: "2026-05-05"
---

Google Antigravity 是 Google 面向 agent-first 开发方式推出的本地开发平台。它不是“又一个 IDE 侧边栏聊天框”，而是把 Editor、Terminal、Browser、Agent Manager、Artifacts 和权限系统放在一起，让开发者以任务为单位编排 agent。

> [!NOTE]
> **先给结论**：第一次学 Antigravity，不要从“它用了哪个模型”开始。先理解 Agent Manager 如何管理异步 agent，Artifacts 如何让你验收结果，权限系统如何限制 terminal、browser、file 和 MCP 行为。

## 两条互补路径

```mermaid
flowchart LR
    Start["Antigravity 中文教程"] --> Official["官方教程中文版"]
    Start --> Understanding["从原理到实战"]
    Official --> Lookup["安装 / Agent Manager / Editor / Browser / Artifacts / 权限"]
    Understanding --> Judgment["定位 / 第一次安全运行 / 工作流 / 对比 / 团队边界"]

    style Start fill:#dbeafe,stroke:#3b82f6,stroke-width:2px
    style Official fill:#dcfce7,stroke:#22c55e
    style Understanding fill:#fef3c7,stroke:#f59e0b
```

<Cards>
  <Card title="📚 官方教程中文版" description="按 Google 官方能力域重组，适合查安装、设置、Agent Manager、Artifacts、Rules、Skills、MCP、权限和排障。" href="/docs/antigravity/official" />
  <Card title="从原理到实战" description="12 篇中文讲解，理解 Antigravity 的 agent-first 工作方式、验收闭环、安全边界和真实项目用法。" href="/docs/antigravity/understanding" />
</Cards>

## 这套教程和官方文档的关系

Google 已经提供 Antigravity 官方站、官方文档、Google Developers Blog 和 Codelab。官方资料适合确认事实，但不一定按中文开发者的学习顺序组织。

这套教程做三件事：

1. 用 Google 官方资料校准产品事实。
2. 把 Antigravity 的能力拆成“查询手册”和“理解路径”两套。
3. 重点解释中文开发者真正会卡住的地方：权限、浏览器子代理、Artifacts 验收、Rules/Workflows/Skills 分工、以及和 Gemini CLI / Codex / Claude Code 的选择边界。

## 怎么选择阅读路径

| 你的状态 | 先读什么 | 目标 |
| --- | --- | --- |
| 还没安装 | [官方教程中文版](/docs/antigravity/official) | 查安装、登录、setup flow 和第一次安全设置 |
| 能打开，但不知道怎么安全用 | [从原理到实战](/docs/antigravity/understanding) | 理解 agent-first IDE 的任务循环和权限边界 |
| 想理解 Agent Manager | [Agent Manager](/docs/antigravity/official/01-agent-manager) | 查 workspace、conversation、Fast/Planning 和多 agent 编排 |
| 想理解验收机制 | [Browser 与 Artifacts](/docs/antigravity/official/03-browser-artifacts) | 查 screenshot、recording、walkthrough、review changes |
| 准备团队使用 | [MCP、权限与安全](/docs/antigravity/official/05-mcp-permissions-security) | 查 Allow/Deny/Ask、terminal sandbox、file access、browser allowlist |

> [!IMPORTANT]
> **不要把 Antigravity 当成“自动写代码神器”来学**。它真正的产品判断是：把 agent 从聊天窗口提升到任务执行者，同时要求你用 Artifacts 和权限系统建立可验收、可回退、可治理的工作流。

## 事实基准

- Google Antigravity 官方站：[https://antigravity.google](https://antigravity.google)
- Google Antigravity 官方文档：[https://antigravity.google/docs](https://antigravity.google/docs)
- Google Developers Blog 发布文：[https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)
- Google Codelab：[https://codelabs.developers.google.com/getting-started-google-antigravity](https://codelabs.developers.google.com/getting-started-google-antigravity)
- Gemini 3 发布文：[https://blog.google/products-and-platforms/products/gemini/gemini-3/](https://blog.google/products-and-platforms/products/gemini/gemini-3/)

## 使用前的安全提醒

Antigravity 可以让 agent 读写文件、执行 terminal 命令、打开浏览器、运行 JavaScript、调用 MCP、生成代码 diff，并通过 Browser Subagent 做 UI 验证。进入真实项目时，先按低风险顺序推进：

1. 第一轮只读：让它解释项目结构和风险点。
2. 第二轮限定写入：只允许改一个文件或一个小组件。
3. 第三轮启用浏览器验收：要求截图、录屏或 walkthrough。
4. 涉及密钥、账号、账单、部署、删除数据时必须人工确认。
5. 长期使用时，把 Rules、Workflows、Skills、MCP 和权限策略沉淀到 workspace，而不是靠临时 prompt。

## 引流出口

- Aaron工作流主站：[xiangyugongzuoliu.com](https://xiangyugongzuoliu.com)
- AI 编程实操课：[课程页](https://flowus.cn/xiangyugongzuoliu/share/d392dcad-b537-44ee-a3e2-56ff5af02bce)
