Google Antigravity 不仅仅是一个编辑器，它是一个“反重力”的开发平台，旨在消除编码中的阻力。它集成了 Google 最新的 Gemini 3 Pro 模型，具备全栈自主权（Full-Stack Autonomy）。

本教程将带你从安装配置开始，到利用 Agent 自动构建一个完整的 Web 应用，体验“指挥官”式的编程快感。

---

第一阶段：下载与环境配置

1. 获取安装包

目前 Antigravity 处于 Public Preview（公测）阶段。

• 官网下载：访问 antigravity.google/download（需科学上网）。

• 平台支持：提供 Windows (.exe), macOS (.dmg, 支持 Apple Silicon), Linux (.deb/.rpm) 版本。

• 安装：像安装 VS Code 一样简单，双击运行即可。

2. 账号登录与授权

启动 Antigravity 后，你会看到一个极简的黑色界面，中心只有一个“G”形光标。

1. 点击左下角的 "Sign In"。

2. 在弹出的浏览器中登录你的 Google 账号。

3. 注意：你需要确保你的账号已开通 Google Cloud 或 AI Studio 的访问权限（通常默认开通）。

3. 关键步骤：配置国内网络/代理

由于 Antigravity 深度依赖云端的 Gemini 3 模型，国内直连通常无法使用。你需要配置代理。

• 方法 A：系统代理（推荐） Antigravity 默认遵循操作系统的代理设置。确保你的梯子开启了“全局模式”或“TUN 模式”。

• 方法 B：手动配置 Model Endpoint（类似 Codex CLI） 如果你有自建的 API 代理（如上一篇文章提到的 Nginx 反代），可以在 Antigravity 中配置：

  1. 按 Cmd/Ctrl + , 打开 Settings。

  2. 搜索 Antigravity: Model Base Url。

  3. 填入你的私有代理地址：https://my-private-proxy.com/v1。

  4. 搜索 Antigravity: Api Key，填入你的 Key。

4. 迁移 VS Code 配置

Antigravity 基于 VS Code 核心魔改，因此支持一键迁移：

• 首次启动时，它会询问："Import settings from VS Code?"

• 点击 Yes。它会自动同步你的主题、快捷键绑定（Keybindings）和已安装的插件（Extensions）。

---

第二阶段：界面概览（这是与 VS Code 不同的地方）

Antigravity 的界面逻辑是为 Agent 服务的：

1. The Gravity Bar (重力栏)：

   • 位置：底部常驻。

   • 作用：这是你与 AI 交流的主入口。你不再是在侧边栏聊天，而是像使用 Alfred/Spotlight 一样，随时呼出 Agent。

2. Mission Control (任务中心)：

   • 快捷键：Cmd/Ctrl + M。

   • 作用：查看当前 Agent 的状态（思考中、执行中、测试中）。你可以看到 AI正在操作你的终端，或者正在修改哪个文件。

3. The Canvas (画布/预览区)：

   • 位置：右侧。

   • 作用：这是 AI 的“白板”。它会在这里画架构图、列任务清单，或者直接渲染网页预览。

---

第三阶段：实战 —— 构建一个“加密货币价格看板”

我们将不写一行代码，完全通过 Prompt 指挥 Agent 完成。

步骤 1：下达指令

在底部的 Gravity Bar 输入：

“创建一个基于 React 和 Tailwind CSS 的单页应用。功能是：每 5 秒刷新一次比特币和以太坊的实时价格。界面要暗黑风格，价格上涨显示绿色，下跌显示红色。”

步骤 2：Plan（规划阶段）

Antigravity 不会立刻写代码，而是会在右侧 Canvas 生成一份 Artifact（工件）：

• 技术栈确认：React (Vite), Tailwind, Axios。

• API 选择：AI 会建议使用 CoinGecko 的公共 API。

• 文件结构：它会列出 src/components/PriceCard.jsx, src/App.jsx 等结构。

你点击 "Approve Plan" (批准计划)。

步骤 3：Execution（执行阶段）

此时，你会看到 Mission Control 开始疯狂滚动：

1. 终端操作：AI 自动运行 npm create vite@latest crypto-tracker。

2. 依赖安装：AI 自动运行 npm install axios tailwindcss postcss autoprefixer。

3. 配置生成：AI 自动初始化 tailwind.config.js。

4. 代码编写：左侧文件树会自动展开，文件内容被快速填充。

步骤 4：Visual Verification（视觉验证 —— 杀手级功能）

这是 Antigravity 最强的地方。

1. 代码写完后，AI 会自动运行 npm run dev。

2. 它会在右侧 Canvas 启动一个内置的 Chrome 浏览器。

3. 自我修正：假设 AI 发现 API 请求跨域报错（CORS Error），或者样式没加载出来。

   • 它会**“看”**到错误信息。

   • 它会自动修改代码（例如更换一个不需要 CORS 的 API，或者添加代理配置）。

   • 它会刷新页面，直到看到正确的绿色/红色价格跳动。

步骤 5：验收与微调

现在应用跑起来了。你觉得字体太小。

• 操作：直接在右侧预览窗口中，用鼠标圈选价格数字。

• 输入：“把这个字体变大，用等宽字体。”

• 结果：AI 瞬间定位到对应的 CSS 类名并修改。

---

第四阶段：高级技巧 —— .antigravity 规则文件

为了让 AI 更懂你的团队规范，你可以在项目根目录创建一个 .antigravity 文件（类似 .gitignore 或 .cursorrules）。

示例配置：

YAML

# .antigravity
project_context:
  framework: "React 18"
  style: "Tailwind CSS"
  state_management: "Zustand"

rules:
  - "所有组件必须使用 TypeScript 编写"
  - "禁止使用 console.log，使用 logger 模块"
  - "每次修改代码后，必须运行 npm test 确保测试通过"

agent_permissions:
  terminal: true  # 允许 AI 操作终端
  browser: true   # 允许 AI 打开浏览器
  file_edit: true # 允许 AI 修改文件

有了这个文件，Antigravity 生成的代码将严格符合你的工程标准。

---

第五阶段：故障排查 (Troubleshooting)

在使用过程中，你可能会遇到以下问题：

Q1: Agent 卡在 "Thinking" 状态很久。

• 原因：通常是网络问题，Gemini 3 Pro 的数据吞吐量很大。

• 解决：检查你的代理连接速度。尝试切换到 Gemini 1.5 Flash 模型（速度快，推理稍弱，适合简单任务）。

Q2: AI 修改了我不希望它动的文件。

• 解决：在 .antigravity 文件中添加 ignore_files: ["src/legacy/**"]。

Q3: 感觉 AI 变笨了，记不住之前的对话。

• 原因：虽然 Gemini 3 支持超长上下文，但 Antigravity 为了响应速度会进行上下文压缩。

• 解决：在 Gravity Bar 输入 /clear 清除历史上下文，或者点击 Mission Control 中的 "New Session" 开启新任务。

---

总结

Google Antigravity 的核心逻辑是：你负责由“做什么”（What），AI 负责“怎么做”（How）。

通过这篇教程，你不仅学会了安装和配置，更体验了一种全新的开发范式。从今天起，不要再对着空白的编辑器发呆，唤醒你的 Agent，让它为你编写未来。