Google Antigravity 2.0 完全使用教程：从下载安装到第一个 AI Agent

快速导读：Google Antigravity 2.0 是 Google 推出的一款自主式 Agent-First（智能体优先）软件工程桌面客户端。与传统的代码补全插件不同，Antigravity 2.0 是一个独立的桌面中央指挥中心，能够自主索引多仓库代码库、制定结构化实施计划、在隔离的 Git Worktree 中执行行级代码变更，并通过内置终端与浏览器进行全自动测试与自愈。本教程带你从 Google Antigravity 官方下载中心 安装开始，一步步完成 Project 目录配置、首条探索 Prompt 下达、代码 Diff 审查与终端测试验证全流程。

---

1. 核心定义：Antigravity 2.0 到底是什么？

Google Antigravity 2.0 是 Google 推出的一款独立的 Agent-First（智能体优先）软件工程桌面客户端。

在过去，AI 辅助编程主要以“编辑器行内补全（Autocomplete）”或“侧边栏聊天窗口（Chat Panel）”的形式存在，开发者依然需要亲自打开文件、定位行数、复制粘贴代码并手动在终端中运行调试。

Antigravity 2.0 彻底颠覆了这种单点交互模式：

• 独立的中央指挥中心（Mission Control）：它不再只是 IDE 里的辅助插件，而是作为一个独立的桌面程序（运行于 Electron / Native 架构），专门负责调度、规划、执行与监控多个并发运行的自主 AI Agent。
• 全自主闭环执行流：赋予 Agent 自主阅读整个项目代码库、制定工程实施方案（Implementation Plan）、就地修改多文件代码、在内置终端中执行构建与单元测试、乃至驱动浏览器进行端到端视觉验收的能力。

传统 AI 补全 (Copilot 模式):
人类思考需求 -> 人类逐行写代码 -> AI 预测下一行 -> 人类手动测试 -> 人类修 Bug

Antigravity 2.0 (Agent-First 模式):
人类下达架构目标 -> Agent 深度读库 -> Agent 输出 Plan -> 人类审批 -> Agent 批量编码并自测 -> 人类审查 Diff -> 一键合并上线

---

2. 解决的痛点：传统开发模式之痛

在严肃的软件研发场景中，开发者的精力往往被海量的低效事务吞噬：

传统开发痛点	Antigravity 2.0 解决方式
大型项目接手难：面对数十万行陌生代码库，理清依赖关系和调用链路需要数天时间。	Agent 可在数秒内建立全局索引，精准回答技术栈、目录拓扑、隐藏依赖与潜在风险。
跨多仓库修改繁琐：全栈任务需要在 frontend/、backend/、docs/ 之间来回切换与同步修改。	单个 Project 支持统一挂载多个物理仓库，Agent 可跨目录协同修改并保持上下文一致。
代码修改缺乏隔离：多 Agent 并发或复杂重构极易污染当前工作目录，导致本地工作区瘫痪。	内置自动化 Git Worktree 隔离机制，每次任务可在物理隔离的临时分支中无污染推进。
测试调试链路断裂：AI 给出的代码往往包含语法错误或破坏已有逻辑，需要反复人工在终端跑测试并回填报错。	集成 2.10.0+ 内置 Terminal 与 Browser MCP，Agent 自主运行构建命令与浏览器测试，遇错自我修复。

---

3. 适用与禁用场景

✅ 推荐使用的黄金场景

1. 全栈新功能与微服务模块开发：从接口定义、前端组件实现到数据库迁移脚本的全套代码编写；
2. 大型代码库工程重构与依赖升级：例如从 CommonJS 迁移至 ESM，或将 React 项目全量升级至 Next.js App Router；
3. 疑难 Bug 定位与全自动自愈测试：提供复现路径，让 Agent 自主写测试、跑测试、修代码直至全部通过；
4. 自动化端到端验收与 SEO 审计：让 Agent 驱动浏览器逐页点击、截图、捕获 Console 报错并出具验收报告。

❌ 不建议使用的反模式场景

1. 简单的单行逻辑补全：若只是修改一个变量名或补全一行三元表达式，传统的编辑器快捷键或轻量级补全工具更加轻快；
2. 涉及不可逆生产环境操作的未经审核任务：严禁在未开启沙箱（Sandbox）的情况下让 Agent 直接对生产数据库执行 DROP 或执行无限制的 rm -rf。

---

4. Antigravity 产品矩阵全景解析

产品形态	定位与核心形态	核心适用人群与场景
Antigravity 2.0 Desktop（本文主角）	独立的桌面客户端（中央指挥中心），具备完整的 Project、Worktree、Artifacts、Browser 与内置 Terminal 调度能力。	专业开发者、架构师、全栈工程师，用于日常复杂工程开发、多 Agent 并行调度。
Antigravity IDE	基于 VS Code 开源核心二次深度定制的 AI-First 代码编辑器，侧重于传统的沉浸式单文件编码与行内 Lens。	习惯传统 IDE 界面、需要密集单文件手写代码与断点调试的开发者。
Antigravity CLI (agy)	轻量级 纯命令行终端 TUI 工具，可在无桌面环境的远程 Linux 服务器或 SSH 终端中极速唤起。	运维工程师、后端云原生开发、远程 CI/CD 自动化流水线。
Antigravity Python SDK	面向开发者的 Agent 编排与工具扩展 Python 库，用于通过代码编程式租赁 Agent 与暴露自定义工具。	想要基于 Antigravity 核心引擎定制自身私有 Agent 平台的企业团队。

---

5. 全平台系统要求与环境准备

1. 操作系统要求

• macOS：macOS 12.0 (Monterey) 或更高版本；原生支持 Apple Silicon（M1/M2/M3/M4 系列芯片）及 Intel 架构；
• Windows：Windows 10 / 11 64-bit（支持 x64 与 ARM64 原生架构）；推荐同时启用 WSL2 环境；
• Linux：Ubuntu 20.04+ / Debian 11+ / Fedora 36+，要求底层依赖 glibc >= 2.31 与 libstdc++6。

2. 必备本地工具链自检

git --version      # Git 2.30+
node -v && npm -v  # Node.js 18+
python3 --version  # Python 3.10+

---

6. 客户端下载与安装一步一步图解

1. 访问官方下载页：直接访问 Google Antigravity 官方下载门户 (antigravity.google/download)。
2. 下载对应安装包：
3. 登录授权：首次启动使用支持 Gemini Enterprise / Google Workspace 的账户完成登录。

---

7. 客户端界面初识：四大核心区域

1. 左侧侧边栏（Left Sidebar）：Projects、Conversations、Scheduled Tasks、Skills & MCP、Settings；
2. 顶部导航栏（Top Bar）：分支状态、全局文件搜索（设置 → Shortcuts 中为该操作配置的快捷键）、会话选择器（Cmd/Ctrl + K）、Terminal 与 VCS 快速开关；
3. 中间主工作区（Chat Canvas）：Thinking Traces、模型选择器、Prompt 输入框（支持 @ 与 /）；
4. 右侧辅助面板（Auxiliary Pane）：Artifacts（Plan / Walkthrough）、Review（行内 Diff）、Screenshots（截图批注）、Browser（自动化测试）、Tasks（后台 Subagent 监控）。

---

8. 创建你的第一个 Project

1. 点击左侧栏 + (New Project)；
2. 关联本地已有单仓库或添加多个子文件夹（frontend/ + backend/ + docs/）。

---

9. 启动并对话你的第一个 AI Agent

输入探索型 Prompt：

请全面阅读并分析当前项目的所有文件与目录结构，并向我汇报：
1. 本项目的业务定位与核心功能是什么？
2. 当前采用的技术栈（框架、语言版本、核心第三方库）是什么？
3. 关键目录结构及其分工职责。
4. 本地启动开发服务器与运行测试的标准命令。
5. 当前代码中是否存在明显的配置缺陷、过期依赖或潜在风险？

---

10. 第一次让 AI 编写与修改代码

输入需求 Prompt：

背景：我们需要增强项目的环境安全性。
目标：在 `src/utils/envCheck.ts` 中实现一个健壮的环境变量校验函数 `validateEnv()`。
要求：
1. 校验必填项 `DATABASE_URL` 与 `API_SECRET`；
2. 如果缺失，抛出包含明确指引的友好错误；
3. 编写对应的单元测试文件 `src/utils/__tests__/envCheck.test.ts`；
4. 采用 TypeScript 严格模式，禁止使用 any。
完成标准：修改完成后，请在终端中运行测试，确保所有测试用例 100% 通过。

在右侧 Review 面板 审查绿色/红色 Diff，点击 Accept All 或选择性 Accept Hunk。

---

11. 运行验证与完成首个任务闭环

1. 按 Cmd/Ctrl + backtick 唤出内置 Terminal；
2. 运行 npm test 确认通过；
3. 打开 VCS 面板，AI 自动生成 Commit Message，点击 Commit & Push。

---

12. 新手最容易踩的 5 大误区与避坑指南

1. 多 Agent 并行误用 Local Mode：切记复杂任务开 New Worktree Mode 隔离；
2. 全局过度放行权限：保持 request-review 或开启沙箱；
3. Prompt 过于宽泛：严格使用 C-O-C-V-A 结构化公式；
4. 长会话导致失忆：及时 New Conversation 并用 @conversation 继承；
5. 忽略 2.10.0+ 内置终端：善用内置终端享受 Agent 自动捕获报错自愈。

---

13. 全局常用快捷键速查表（Cheat Sheet）

快捷键 (macOS)	快捷键 (Windows/Linux)	功能描述
Cmd + L	Ctrl + L	快速定位至 Prompt 输入框
设置 → Shortcuts 中为该操作配置的快捷键	设置 → Shortcuts 中为该操作配置的快捷键	全局文件检索与快速跳转
Cmd + K	Ctrl + K	打开 Conversation 会话选择器
设置 → Shortcuts 中为该操作配置的快捷键	设置 → Shortcuts 中为该操作配置的快捷键	开启全新 Conversation
Cmd + backtick	Ctrl + backtick	唤出 / 收起内置 Terminal 终端
设置 → Shortcuts 中为该操作配置的快捷键	设置 → Shortcuts 中为该操作配置的快捷键	一键展开右侧 Review 代码审查面板
设置 → Shortcuts 中为该操作配置的快捷键	设置 → Shortcuts 中为该操作配置的快捷键	发送当前多行 Prompt

---

14. 官方与权威资料索引

• 官方网站：Google Antigravity 官方首页
• 官方文档：Antigravity 2.0 入门官方指南
• 开发者教程：Google 官方 Codelab 实战
• 版本更新日志：Antigravity Release Changelog

---

15. 系列教程路线图与下一篇导引

👉 下一篇推荐阅读：02 · Antigravity 2.0 界面完全解析：每一个按钮、面板和快捷键都是干什么的