Google Antigravity 中文教程：从零开始使用 AI 代码编辑器（2026）

Google Antigravity 是 Google 于 2025 年 11 月发布的 AI 代码编辑器，基于 VS Code 架构，由 Gemini 3 驱动。本文是面向中文开发者的完整入门教程。

Antigravity 是什么？

Antigravity = VS Code 架构 + AI 代理

与传统 AI 编码工具（GitHub Copilot、Cursor）的"逐行建议"不同，Antigravity 采用**代理优先（Agent-First）**架构——AI 代理可以自主规划、编写和测试跨文件的完整功能：

你说：帮我写一个用户注册接口，包含邮箱验证和 JWT 认证
代理做：创建路由 → 写验证逻辑 → 安装依赖 → 写测试 → 运行测试

核心数据（2026 年 4 月）：

SWE-bench Verified 得分：76.2%（业界领先）
发布时间：2025 年 11 月 18 日
基础架构：VS Code fork
主要模型：Gemini 3.1 Pro（付费计划）、Gemini Flash（免费计划）
额外支持：Claude Sonnet 4.6、GPT-4o

定价与使用限制（重要）

很多中文教程跳过了这一块，导致用户上手后发现额度很快耗尽。先把这个说清楚。

三档定价

| 计划 | 价格 | 代理请求 | 模型 | |------|------|----------|------| | Free | $0/月 | ~20次/天 | Gemini Flash | | AI Pro | $20/月 | ~100次/天 | 更强模型 | | AI Ultra | $249.99/月 | 高配额，无周上限 | Gemini Ultra + 实验模型 |

免费版的现实情况

免费版在 2025 年 11 月发布时每天有 250 次代理请求，但 2025 年 12 月被削减到 20 次/天，降幅 92%。

刷新机制：

免费版：每 5 小时刷新一次（不是每天凌晨重置）
AI Pro：每周刷新（注意：可能出现长达 168 小时的锁定期）

Credits 追加系统（2026 年 3 月新增）

用完额度后，可以购买 Credits 继续使用：

价格：$0.01/个，$199 买 20,000 个
设置路径：Settings → AI Credit Overages → Always（开启后额度耗尽自动扣 Credits）

重要提示：Tab 代码补全是无限的，消耗额度的是"代理任务执行"。

安装步骤

下载

前往 antigravity.google 下载：

Windows：.exe 安装程序
macOS：.dmg
Linux：.AppImage 或 .deb

安装

Windows 用户：

双击 .exe，按提示安装
安装完成后桌面出现 Antigravity 图标

macOS 用户：

打开 .dmg，将 Antigravity 拖入 Applications
首次打开右键 → 打开（绕过 Gatekeeper 安全提示）

Linux 用户：

# AppImage 方式
chmod +x Antigravity-*.AppImage && ./Antigravity-*.AppImage

# .deb 包
sudo dpkg -i antigravity_*.deb

登录 Google 账号

Antigravity 需要 Google 账号访问 Gemini：

启动后点击右上角 Sign in with Google
建议使用个人 Gmail 账号（企业 Workspace 账号在某些功能上有限制）
登录成功后状态栏显示 Gemini 模型状态

导入 VS Code 配置（可选）

欢迎界面 → Import from VS Code → 选择要导入的内容（快捷键、主题、扩展）

网络问题（中国大陆用户必读）

Antigravity 连接 Gemini API，在中国大陆需要配置代理。

方式一：系统代理 Antigravity 自动读取系统代理设置。在操作系统的网络设置中配好代理，无需额外操作。

方式二：Antigravity 内手动设置 打开设置（Ctrl+,），搜索 proxy，在 Http: Proxy 填入代理地址，例如：

http://127.0.0.1:7890

方式三：Google AI Studio API Key（推荐） 在 aistudio.google.com 申请免费 API Key，然后在 Antigravity 的模型设置中填入，这样你的 Gemini 配额来自 AI Studio 账户，与 Antigravity 内置配额分开计算。

界面介绍

界面和 VS Code 几乎一样，主要新增部分：

| 区域 | 功能 | |------|------| | Agent 面板（右侧或底部） | 输入任务、查看代理执行过程 | | 状态栏模型选择器 | 切换 Gemini Flash / Pro 等 | | Credits 指示器 | 显示当前额度剩余 | | 检查点指示器 | 代理执行前自动保存的还原点 |

第一个代理任务

打开项目：文件 → 打开文件夹 → 选择项目目录

启动代理：按 Ctrl+I（Windows/Linux）或 Cmd+I（macOS）

输入任务（中英文都可以）：

帮我在 src/utils/ 下创建一个 email.ts 文件，
包含邮箱格式验证函数，并写配套的单元测试

查看执行过程：

计划：代理列出步骤
执行：实时显示文件变更
验证：可能自动运行测试
汇报：总结完成情况

审查变更：所有改动以 diff 形式展示，你可以逐个接受或拒绝，或"全部接受"。

节省配额的使用策略

免费版只有 20 次/天，用对了才够用。

什么时候用代理，什么时候不用

| 任务类型 | 建议 | |----------|------| | 写完整功能（多文件） | 用代理，物有所值 | | 解释一段代码 | 用普通聊天，不消耗代理配额 | | 修改单个函数 | 用普通聊天 + 自己接受建议 | | 跑测试、安装依赖 | 用代理（节省手动操作时间） | | 格式化、重命名 | 用内置功能或插件，不用 AI |

批量处理

把相关的小任务合并成一个代理任务，效率更高：

❌ 三次单独请求：添加类型 → 加注释 → 写测试（消耗3次）

✅ 一次请求：给 authUtils.ts 里的所有函数添加 TypeScript 类型标注，
   加简短 JSDoc 注释，并为每个函数写单元测试（消耗1次）

编写 AGENTS.md

AGENTS.md 放在项目根目录，告诉代理如何在你的项目中工作——避免每次都重复说明相同的规则。

# 项目说明

## 技术栈
- 语言：TypeScript
- 框架：Next.js 14（App Router）
- 样式：Tailwind CSS
- 数据库：MySQL + Prisma

## 代码规范
- 使用函数式组件，不用类组件
- 变量命名：驼峰命名法（camelCase）
- 所有函数必须有 TypeScript 类型标注

## 测试要求
- 使用 Vitest 写单元测试
- 测试文件放在 __tests__/ 目录
- 每次修改后运行 npm test

## 禁止事项
- 不要在生产代码中加 console.log
- 不要硬编码环境变量，必须用 .env 文件

关于 Nano Banana Pro

你可能在 Antigravity 的功能列表里看到 Nano Banana Pro 这个名字。

它不是某个快捷操作——它是 Google DeepMind 的 AI 图像生成模型（基于 Gemini 3 Pro Image），集成在 Antigravity 的代理工作流中。当代理认为需要生成视觉资产（UI 原型图、数据可视化、演示文稿图片等）时，会自动调用它。

用户不需要手动触发，代理会在合适的时候自动使用。详见 Nano Banana Pro 介绍文章。

常见问题

Q：免费版够用吗？

对于轻度使用（每天几个简单任务）基本够用。对于全职开发，20 次/天很快会到上限。可以考虑：

等待 5 小时刷新
购买 Credits（$0.01/个）
升级 AI Pro（$20/月）

Q：和 Cursor 相比，哪个更好？

核心能力：Antigravity 的代理能力目前更强（SWE-bench 76.2% vs Cursor ~55%），且有 Nano Banana Pro 图像生成。但 Cursor 发布更早，某些细节体验更成熟，且有 $0 + 无限额度的付费方案（按 API 用量计费）。

详细对比见Antigravity vs Cursor 对比文章。

Q：Antigravity 会上传我的代码吗？

是的，代理执行时会将上下文发送给 Gemini API。如果项目有严格的保密要求，请查看 Google 的隐私政策，或考虑使用自己的 API Key（通过 Vertex AI/AI Studio）以便对数据处理有更多控制。

Q：为什么叫"Antigravity"？

名字来自两个开发者文化彩蛋：Python 的 import antigravity（会打开一幅关于"用代码飞翔"的 XKCD 漫画）和早年的"Google Gravity"浏览器实验。Google 用这个名字传达"让开发变得无负担"的产品理念。详见Antigravity 名字由来。

下一步

使用限制详情 — 配额、刷新机制、Credits 系统
定价页面 — 三档计划对比
Nano Banana Pro 介绍 — AI 图像生成功能详解
IDE 完整教程系列 — 从安装到高级工作流