在人工智能爆发的今天，你可能用过 ChatGPT 帮你写代码片段，或者用过 GitHub Copilot 自动补全代码。但你是否体验过一个*
*能自己看懂项目、自己设计方案、自己创建文件、甚至自己运行和调试代码**的“全自动” AI 助手？
这就是 Antigravity —— 由 Google DeepMind 团队倾力打造的新一代 Agentic AI（智能体）编程助手。
本篇指南将从零开始，手把手带你完成 Antigravity 的安装、配置，并分享如何高效指挥它为你工作的实战技巧。*
全文已进行脱敏处理，国内用户可放心阅读与分享！*
💡 第一部分：走进 Antigravity —— 为什么它与众不同？
传统的 AI 助手是“问答式”的：你问一句，它回一段代码，你再手动复制到编辑器里。
而 Antigravity 是“任务驱动式”的智能体（Agent）：
- 自主感知：它能直接读取你整个项目的目录结构和文件内容。
- 规划能力：面对复杂的任务（比如“帮我开发一个带后台的留言板”），它会先撰写一份《实施方案》（Implementation
Plan），让你审核通过后再动手。 - 工具使用：它拥有自己的“手和脚”——能够自动创建/修改代码文件，甚至在终端运行测试和编译命令。
- 安全可控：它在执行任何敏感操作（如修改文件、运行命令）之前，绝对会先弹窗征求你的批准（Approve），安全防线始终在你自己手里。
🛠️ 第二部分：准备工作
在正式安装前，请确认你的电脑和网络环境满足以下条件：
1. 兼容的操作系统
- macOS：支持 Intel 和 Apple Silicon (M1/M2/M3) 芯片。
- Windows：Windows 10 及以上系统。
- Linux：主流发行版均支持。
2. 网络环境准备
由于 Antigravity 依赖 Google 的全球云端 AI 服务：
- 请确保你的电脑网络能够顺畅访问海外的主流学术与技术资源。
- 如果在首次登录或下载时遇到页面无法加载，请自行检查并开启你的网络辅助工具。因平台合规要求，具体配置方法请自行探索（相信大家都懂的
😉）。
3. 准备 Google 账号
- Antigravity 需要绑定你的 Google 账号来激活 AI 模型（推荐准备一个 Gmail 邮箱）。
- 如果你还没有账号，请在畅通的网络环境下，自行通过常规渠道前往 Google 官网注册。
📥 第三部分：版本选择 —— 桌面版 vs IDE 插件版
Antigravity 提供了两种形态，它们的核心能力是一样的，但使用场景有所不同：
| 特性 | 桌面版 (Desktop App) 🌟（推荐） | IDE 版 |
|---|---|---|
| 适合人群 | 编程新手、产品经理、日常轻度开发者 | 专业程序员、习惯在编辑器中工作的开发者 |
| 安装难度 | 极低（像安装普通软件一样双击安装） | 较低（像安装普通软件一样双击安装） |
| 独立性 | 独立窗口运行，UI 界面更美观、易交互 | 嵌入在编辑器侧边栏中，编写代码时更连贯 |
| 下载地址 | 点击访问桌面版下载页面 | 点击访问 IDE 版下载页面 |
⚙️ 第四部分：手把手安装与避坑指南
1. 桌面版安装步骤
🍏 macOS 安装
- 点击下载对应的
.dmg格式安装包。 - 双击打开
.dmg文件，将 Antigravity 图标拖拽到右侧的 Applications（应用程序） 文件夹中。 - 避坑指南：首次打开时，如果系统提示“无法打开，因为无法验证开发者”，请不要慌。打开 Mac 的 **“系统设置” -> “隐私与安全性”
**，向下滑动找到安全性部分，点击 “仍要打开” 即可。
💻 Windows 安装
- 点击下载
.exe安装程序。 - 双击运行，根据安装向导一路点击“下一步”即可完成。
- 避坑指南：如果 Windows Defender 弹出“阻止了未识别的应用启动”，点击 “更多信息”，然后选择 “仍要运行”。
⚙️ 第五部分：核心配置（如何正确设置“大脑”和“手”）
安装完成后，打开软件，我们需要进行三项关键配置：
步骤 1：账号登录
- 启动 Antigravity，点击界面上的 "Sign in with Google"。
- 系统会自动跳转到你的默认浏览器，选择你的 Google 账号并完成授权。
- 授权成功后，浏览器会提示你返回客户端，此时 Antigravity 界面将被成功激活。
步骤 2：选择你的 AI 模型 (Model Selection)
Antigravity 支持切换不同的 Gemini 模型。点击软件左下角的设置齿轮 (Settings)，找到 Model Selection：
- Gemini 3.1 Pro (High) 🌟（强烈推荐）：它是最聪明的“全能大脑”，擅长处理逻辑复杂、需要深度规划和编写多文件协作的代码任务。
- Gemini 3.5 Flash (Medium)：响应速度极快，适合日常简单的代码问答、修改个别错字或快速查阅文档。
步骤 3：合理设置“工作区 (Workspace)”
工作区是 AI 大显身手的舞台，配置它非常关键：
- 建议在你的电脑里（如“文档”或“用户”目录下）新建一个专用的文件夹，命名为
MyAIProjects。 - 在 Antigravity 中点击 "Open Folder"，选择这个文件夹作为当前的工作区。
- ⚠️ 安全警告：千万不要将电脑的根目录（如 C 盘、D 盘）或者你的整个用户主目录设置为工作区。因为 AI
助手有文件修改权限，如果工作区范围过大，可能会误读或影响到你的系统个人文件。
💡 第六部分：实战指南 —— 如何指挥 AI 为你工作
配置好工作区后，你就可以开始输入你的第一个指令了。这里介绍 Antigravity 的核心工作流程：
1. 提出宏大的目标 (Goal)
你可以像对真人程序员说话一样下达命令：
✍️ “帮我用 HTML + CSS + JS 写一个精致的个人待办事项（To-Do
List）网页，要求支持暗黑模式，并且任务可以缓存在浏览器里，刷新页面不丢失。”
2. 方案确认（Planning Mode）
当你输入复杂任务后，Antigravity 不会盲目写代码，而是会自动进入规划模式：
- 它会生成一个
implementation_plan.md（实施方案文档）。 - 文档中会列出它准备新建哪些文件（如
index.html,style.css,app.js），以及具体的设计逻辑。 - 你需要做什么：仔细阅读这个方案，如果觉得可行，直接在聊天框中回复“同意”或点击批准。
3. 安全审批（Command & File Approvals）
在编写代码和运行项目时，AI 会调用系统工具：
- 当它要写入/修改文件时，界面上会弹出绿色/红色的代码差异对比（Diff），并让你确认。
- 当它要在终端运行调试命令（如启动本地网页服务器）时，会向你申请命令行运行权限。
- 安全提示：请养成良好的审核习惯，仔细确认它要执行的命令行是否安全，确认无误后再点击 Approve。
🚀 第七部分：进阶玩家技巧
- 活用子智能体 (Subagents)：在处理极其庞大的项目时，你可以让 Antigravity
派生出专门负责“调研文献”或“数据库调试”的子智能体（Subagent），它们会在后台并行工作，互不干扰，最后向主程序汇总报告。 - 编写清晰的 Prompt：给 AI 提需求时，尽量遵循 “角色 + 上下文 + 目标 + 限制条件” 的原则。例如：“
你是一个前端专家，在当前工作区下，帮我重构 app.js 中的数据持久化逻辑，改用 LocalStorage，不要修改原有的 CSS 样式。”
❓ 第八部分：常见故障排查 (Troubleshooting)
Q：登录时浏览器提示“无法连接到服务器”或“无法显示页面”？
A：这通常是因为网络环境问题。请确认你的海外网络访问工具已经开启了“全局代理”模式，或者在系统设置中确认代理端口配置正确。
Q：AI 报错提示“权限不足 (Permission Denied)”？
A：当 AI 尝试读取工作区以外的文件，或者尝试运行需要系统管理员（sudo）权限的命令时会报此错误。请确保你的工作区设置在普通用户目录下（如
/Users/用户名/Documents/），且不要让 AI 运行高风险的系统级指令。
Q：如何查看 AI 运行的本地日志？
A：Antigravity 会在系统后台静默保存日志，你可以在用户目录下的
.gemini/antigravity目录中找到相关的 log
文件，用于调试或查看详细的历史工作流。
🎉 祝贺你！你已经掌握了 Antigravity 的全部奥秘。现在，打开你的工作区，向 AI 发送你的第一个开发指令吧！
