---
title: "Antigravity 从原理到实战"
description: "按中文开发者学习顺序讲清 Antigravity：定位、安装、Agent Manager、Artifacts、Browser、Rules、Skills、MCP、权限、安全和真实项目实践。"
verifiedAt: "2026-05-05"
---

这一组不是官方功能清单，而是 Antigravity 的学习路径。它按“从第一次打开，到能放进真实项目”的顺序讲：先理解它是什么，再学安全运行、任务编排、Artifacts 验收、浏览器验证、规则沉淀、权限治理，最后进入团队边界和最佳实践。

> [!NOTE]
> **这一组解决什么问题**：让你把 Antigravity 从“看起来很强的新 IDE”理解成“需要被管理的 agent 工作台”。读完以后，你应该能自己设计一套安全、可复用、可验收的 Antigravity 使用方式。

## 学习路线

```mermaid
flowchart LR
    A["定位"] --> B["第一次安全运行"]
    B --> C["Editor vs Agent Manager"]
    C --> D["Agent 任务循环"]
    D --> E["Artifacts 验收"]
    E --> F["Browser Subagent"]
    F --> G["Rules / Workflows / Skills"]
    G --> H["MCP / 权限 / Sandbox"]
    H --> I["真实项目 walkthrough"]
    I --> J["工具对比"]
    J --> K["团队边界"]
    K --> L["最佳实践清单"]
```

<Cards>
  <Card title="01 · Antigravity 是什么" description="把它从 AI IDE 重新理解成 agent-first 开发平台。" href="/docs/antigravity/understanding/01-what-is-antigravity" />
  <Card title="02 · 第一次安全运行" description="安装后不要立刻放权，先跑只读、单文件、浏览器验收三步。" href="/docs/antigravity/understanding/02-install-first-safe-run" />
  <Card title="03 · Editor 与 Agent Manager" description="理解什么时候亲手编辑，什么时候像工程经理一样派发 agent。" href="/docs/antigravity/understanding/03-editor-vs-agent-manager" />
  <Card title="04 · Agent 任务循环" description="拆开计划、执行、观察、验证、反馈和回退。" href="/docs/antigravity/understanding/04-agent-loop" />
  <Card title="05 · Artifacts 验收" description="用 task list、implementation plan、diff、screenshot、walkthrough 建立信任。" href="/docs/antigravity/understanding/05-artifacts-review-workflow" />
  <Card title="06 · Browser Subagent" description="让浏览器验证成为 UI 任务的默认交付标准。" href="/docs/antigravity/understanding/06-browser-subagent-ui-testing" />
  <Card title="07 · Rules / Workflows / Skills" description="把高频约定沉淀成 Rule、Workflow、Skill 三层。" href="/docs/antigravity/understanding/07-rules-workflows-skills" />
  <Card title="08 · MCP、权限与 Sandbox" description="把 Allow/Deny/Ask 写成资源字符串，配 Strict Mode 与 sandbox。" href="/docs/antigravity/understanding/08-mcp-permissions-sandbox" />
  <Card title="09 · 真实项目 walkthrough" description="把前 8 篇合成一条完整前端任务流程。" href="/docs/antigravity/understanding/09-real-project-walkthrough" />
  <Card title="10 · 工具对比" description="按入口、证据、治理选 Antigravity / Gemini CLI / Codex / Claude Code。" href="/docs/antigravity/understanding/10-antigravity-vs-gemini-cli-codex-claude-code" />
  <Card title="11 · 团队安全边界" description="账号、workspace、权限、MCP、Browser、Artifact、发布六大边界。" href="/docs/antigravity/understanding/11-team-security-boundaries" />
  <Card title="12 · 最佳实践清单" description="商业级上线前的 12 节 checklist + 复盘表。" href="/docs/antigravity/understanding/12-best-practices-checklist" />
</Cards>

## 读这组文章前的默认设置

第一次使用 Antigravity，建议采用保守配置：

| 设置 | 推荐值 | 原因 |
| --- | --- | --- |
| Terminal execution | Request Review | 先看清 agent 会跑什么命令 |
| Artifact review | Asks for Review | 让计划、实现和 walkthrough 都进入人工验收 |
| JavaScript execution | Request Review 或 Disabled | 降低浏览器 prompt injection 风险 |
| File access | Workspace only | 不让 agent 自动读写工作区外的密钥和私人文件 |
| Browser URL allowlist | 只加任务需要的域名 | 浏览器能力越强，越要收窄访问边界 |

## 不建议的学习方式

| 反模式 | 问题 | 正确做法 |
| --- | --- | --- |
| 一上来选最大自治模式 | 很难判断 agent 是否误删、误跑、误访问 | 从 Request Review 开始逐步放权 |
| 只看模型名字 | 忽略了 Manager、Artifacts、Browser、权限这些真正差异 | 先学工作流和治理 |
| 把所有约定写进一条 prompt | 不可复用、不可审计、下次还要重讲 | 拆成 Rules、Workflows、Skills |
| 不看 walkthrough 只看最终代码 | 失去 Antigravity 的验收优势 | 要求截图、录屏、diff 和测试说明 |

## 学完后的检查点

读完这一组后，至少要能完成三件事：第一，判断一个任务应该放在 Editor、Agent Manager 还是 Browser Subagent；第二，能用 Artifacts 判断 agent 做了什么、为什么这么做、如何验证；第三，能把高频约定沉淀成 Rules、Workflows 或 Skills。只会让 agent 写代码还不够，Antigravity 的核心价值在于把计划、执行、观察和验收放在同一个工作台里。

如果你还不能解释权限、sandbox、URL allowlist 和 walkthrough 的作用，先不要把它接入生产仓库。先用一个 demo repo 跑通只读解释、小范围修改、浏览器验收和人工 review，再逐步提高自治程度。

## 接下来去哪

<Cards>
  <Card title="从定位开始" description="第一次系统学习从 Antigravity 是什么开始。" href="/docs/antigravity/understanding/01-what-is-antigravity" />
  <Card title="查官方功能" description="如果你只想查某个设置项，直接去官方教程中文版。" href="/docs/antigravity/official" />
</Cards>
