Google Antigravity IDE 全流程上手指南（谷歌反重力）
“不是AI帮你写代码，而是AI以工程师身份独立完成项目”
—— 基于 Gemini 3 Pro + Agent-First 架构的下一代智能开发环境
✅ 一、核心认知：Antigravity 是什么？
Antigravity 是 Google 推出的首个真正意义上的「智能体优先」（Agent-first）AI IDE，并非传统插件或 Copilot 式辅助工具，而是：
- 深度集成 Gemini 3 Pro 模型（支持 High/Low/Flash 多档位调度），并兼容 Claude Sonnet 4.5 / Opus 4.5、GPT-OSS 120B 等第三方模型；
- 基于 VS Code 架构构建，保留全部编辑器习惯，但底层运行机制彻底重构：AI 可自主执行 PLANNING（规划）→ CODING（编码）→ TESTING（测试）→ DEBUGGING（调试）→ DOCUMENTING（生成文档）全流程；
- 专为复杂工程设计：自动处理多文件协调、依赖分析、API 验证、异步环境配置（如
aiohttp爬虫）、单元测试生成与结果输出，实测 10 分钟内交付知乎热榜爬虫完整项目； - 强调人机协作边界：开发者定义目标与规则（Rules），AI 承担执行；非“黑箱生成”，而是全程可追溯、可干预、可审计的闭环开发。
⚙️ 二、硬性前置条件（缺一不可）
| 条件 | 说明 | 验证方式 |
|---|---|---|
| ✅ 美国地区 Google 账号 | 账号必须关联美国（非仅 IP 或支付方式），否则登录卡死 | 访问 https://policies.google.com/country-association-form 查看并提交换区申请 |
| ✅ 稳定美国网络出口 | 需 SOCKS5/HTTP 代理（推荐端口 10808 或 10000），不强制要求 TUN 模式 |
可通过 antigravity-proxy 注入 DLL 实现无 TUN 代理；亦可用 Proxifier 配置 antigravity.exe 进程级代理 |
| ✅ 官方安装包 | 仅支持从唯一官网下载：https://antigravity.google | 切勿使用 npm、GitHub Release 等非官方渠道（当前无 CLI 安装方式） |
🔔 重要提醒：
- 换区审核通过率较低，账号历史行为（如常用代理地域）直接影响判定，建议新注册纯净美区账号；
- 避免使用港澳节点——系统会识别并拒绝服务；
- 免费用户默认使用 Gemini 3 Flash；开通 Gemini Advanced 可解锁 Gemini 3 Pro 高配额与 Thinking 模式。
📥 三、安装与初始化（3 分钟极速完成）
▪ 步骤 1：下载与基础环境检查
- 访问 https://antigravity.google 下载对应系统安装包（Windows/macOS/Linux 均支持）；
- 启动前确认：
✅ 已运行代理软件（Clash/V2Ray 等），本地监听127.0.0.1:10808（或其他自定义端口）；
✅ Google 账号已切换至美国地区；
✅ 网络可正常访问https://policies.google.com（用于后续验证）。
▪ 步骤 2：无 TUN 代理方案（推荐中国用户）
✨ 替代 Proxifier 的轻量级方案：
antigravity-proxy（开源项目）
四步完成：
- 下载 https://github.com/yuaotian/antigravity-proxy/releases 最新版 ZIP；
- 解压后修改
config.json中proxy.port为你代理的实际端口（如 ClashN 默认 7890，V2RayN 默认 10808）；- 将
version.dll+config.json复制到 Antigravity 安装目录根路径（非resources/app子目录！）；- 重启 IDE —— 流量自动经代理转发，无需系统级 TUN。
步骤 3：首次登录与 IDE 初始化
- 启动 Antigravity → 点击右上角 Sign in with Google；
- 使用美区账号登录 → 连续点击 Next 完成工作区初始化；
- 登录成功后，自动加载 Gemini 3 Pro 模型并检测本地环境（Python/Go/Rust 等语言栈自动识别）。
🌍 四、双中文设置（界面 + AI 输出）
▪ 1. 界面汉化（VS Code 兼容方案）
Antigravity 完全复用 VS Code 国际化机制：
- 左侧边栏点击 Extensions（扩展）图标；
- 搜索
Chinese (Simplified)→ 安装官方语言包； - 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac）打开命令面板； - 输入
Configure Display Language→ 选择Chinese (Simplified)； - 重启 IDE 生效。
💡 提示：部分菜单项（如 Agent Manager 标签）可能仍为英文，属正常现象，不影响功能使用4。
▪ 2. 强制 AI 全链路中文（关键！）
需在 Rules 系统层设置全局语言策略，确保：
✅ 用户提问用中文 → AI 用中文回复；
✅ 生成代码注释、计划文档（implementation_plan.md）、walkthrough.md 全部中文；
✅ 错误提示、调试日志、测试断言均使用中文表述。
操作路径：
- 右侧打开 Agent Manager → 点击
⋯→ Customizations； - 选择 Rules → 自动创建/打开
GEMINI.md
language: Chinese- 保存 → 新建 Chat 对话测试：“帮我写一个贪吃蛇游戏”，验证输出是否全中文。
配额查询
在插件市场搜索 wusimpl Antigravity Quota Watcher @sort:name，认准作者为 wusimpl 的插件，点击安装即可。
然后可在底栏中查看每个模型的配额情况！
🧠 五、进阶生产力技巧（提升 300% 开发效率）
| 技巧 | 说明 | 来源 |
|---|---|---|
| 🔹 Tab 键 = 万能遥控器 | 输入函数骨架（如 def fib(n):），光标停在末尾 → 按 Tab 自动补全逻辑 + 预加载单元测试建议（如 assert fib(10) == 55） |
|
| 🔹 Rules 规则引擎 | 在 GEMINI.md 中定义工程规范：<br>❗ 所有函数必须含 docstring<br>❗ main.py 仅作入口，逻辑拆分至 modules/<br>❗ 代码必须符合 PEP8 —— AI 将严格遵守 |
|
| 🔹 多模型动态调度 | 底栏可实时查看各模型剩余配额（需安装扩展 AntigravityQuotaWatcher）；高负载任务切 Gemini 3 Pro(High)，快速润色用 Gemini 3 Flash |
|
| 🔹 浏览器子代理（Browser Sub-Agent） | 在 Rules 中启用 browser_subagent: true，AI 可自动调用内置浏览器完成网页抓取、表单填写、截图验证等操作 |
|
| 🔹 账号额度管理 | 使用 Antigravity-Manager 工具切换多个 Google 账号，实现配额叠加与模型隔离 |
📈 六、模型与配额：免费时代的理性选择
| 模型 | 特点 | 推荐场景 | 配额提示 |
|---|---|---|---|
| Gemini 3 Pro (High) | 最强推理+多模态+长上下文（1M tokens） | 架构设计、复杂算法推导、跨文件重构 | 免费用户每日约 50 次高负载请求 |
| Claude Sonnet 4.5 (Thinking) | 强逻辑链+逐步推理可视化 | 数学证明、协议逆向、安全审计 | 开启 Thinking 后延迟+30%，但正确率+22% |
| Gemini 3 Flash | 超低延迟（<300ms）、高吞吐 | 实时补全、代码格式化、快速问答 | 免费额度最宽松，几乎不限速 |
| GPT-OSS 120B (Medium) | 开源模型（本地部署选项） | 隐私敏感项目、离线开发 | 需手动配置 Ollama/vLLM 后端6 |
🔍 配额监控：安装社区扩展 https://github.com/wusimpl/AntigravityQuotaWatcher 后，状态栏实时显示各模型剩余请求次数与重置倒计时[你的原文]。
❓七、高频问题速查（Q&A）
| 问题 | 原因与解决方案 |
|---|---|
| ❌ 登录无反应 / 卡在 Loading | ① 检查账号是否为美区（非港澳）；② 关闭所有代理软件重试；③ 清除浏览器缓存后重登（IDE 内嵌 Chromium） |
| ❌ 中文规则不生效 | 确认 GEMINI.md 保存在 当前工作区根目录（非用户主目录）；检查文件编码为 UTF-8 无 BOM；重启后新建对话测试 |
| ❌ 代理失效 / 请求超时 | 使用 antigravity-proxy 时，确认 version.dll 与 config.json 位于 Antigravity .exe 同级目录；检查代理端口是否被防火墙拦截 |
| ❌ Gemini 3 Pro 不可用 | 免费用户默认限流；需订阅 Gemini Advanced；或在 Settings → Model Selection 中手动切换 |
| ❌ 文件操作失败（如自动生成 zhihu_crawler.py） | 检查工作区权限（尤其 Windows 下防病毒软件拦截）；关闭 OneDrive 实时同步；尝试以管理员身份运行 |
📚 七、延伸学习资源
- 🔗 官方文档入口：https://antigravity.google/docs（需科学访问）
- 🔗 配额监控扩展：https://github.com/wusimpl/AntigravityQuotaWatcher
- 🔗 无 TUN 代理工具：https://github.com/yuaotian/antigravity-proxy
- 🔗 账号管理工具：https://github.com/lbjlaq/Antigravity-Manager
- 🔗 实战案例库：知乎热榜爬虫、React 组件生成、Rust WASM 项目搭建等完整 walkthrough
相关文档
评论与补充0
有问题或想补充的，写在下面 · 选中正文文字再点「报告错误」会自动引用还没有评论。有疑问、补充，或者发现错字，都可以写在下面。
回复