Google Antigravity 故障排除：修复常见问题

本指南提供服务器崩溃、登录循环和代理执行错误的全面解决方案。

目录

• 无限加载/生成问题
• 服务器崩溃问题
• 登录和身份验证问题
• 代理执行错误
• 浏览器扩展问题
• 安装问题
• MCP 服务器问题
• 常见问题解答

无限加载/生成问题 ⏳

Antigravity 卡在”生成中…”或”工作中…”

代理显示无限加载，没有响应或进度

为什么会发生这种情况

Antigravity 显示”生成中…”通常意味着某个工具没有返回响应。这可能由以下原因引起：

• 工具执行挂起（文件监视器、服务器、长时间运行的进程）
• 网络请求超时
• 外部 API 调用无响应
• 浏览器扩展等待用户输入
• 规划模式陷入循环

解决方案

1. 取消操作 – 点击停止按钮中断当前任务
2. 检查挂起的进程 – 在终端中查找仍在运行的命令
3. 刷新界面 – 重新加载 Antigravity 窗口
4. 开始新对话 – 创建新的聊天会话
5. 简化请求 – 将复杂任务分解为更小的步骤
6. 检查网络连接 – 确保稳定的互联网连接
7. 禁用规划模式 – 如果代理在规划阶段卡住

使用智能规则防止未来的加载问题

许多无限加载问题源于不清晰的提示或缺失的上下文。配置自定义规则以提供：

• 明确的编码标准和最佳实践
• 项目特定的上下文和约束
• 首选的库和框架
• 错误处理指南

这有助于 Antigravity 更高效地工作，减少需要澄清的往返次数。

React 和现代 JavaScript

你是 React、TypeScript 和现代 JavaScript 开发的专家。

关键原则：
– 使用函数组件和 Hooks
– 优先使用组合而非继承
– 遵循单一职责原则
– 使用 TypeScript 进行类型安全
– 实现适当的错误边界

Python AI/ML 开发专家

你是 Python、AI 和机器学习开发的专家。

关键原则：
– 遵循 PEP 8 风格指南
– 使用类型提示以提高代码清晰度
– 实现适当的错误处理
– 编写全面的文档字符串
– 使用虚拟环境进行依赖管理

Next.js App Router 最佳实践

你是 Next.js App Router 的专家。

关键原则：
– 尽可能使用服务器组件
– 仅在需要时实现客户端组件
– 利用并行路由和拦截
– 使用 Server Actions 进行数据变更
– 实现适当的加载和错误状态

服务器崩溃问题 💥

Antigravity 服务器意外崩溃

“Antigravity 服务器意外崩溃。请重启以恢复完整的 AI 功能”

解决方案

1. 重启应用 – 大多数崩溃通过简单重启即可解决
2. 清除应用缓存 – 删除临时文件和缓存数据
3. 检查系统资源 – 确保至少有 4GB 可用 RAM
4. 禁用硬件加速 – 如果问题持续存在，在设置中禁用
5. 更新到最新版本 – 检查并安装可用更新
6. 检查日志文件 – 查看崩溃报告以获取具体错误

登录和身份验证问题 🔄

卡在”设置您的账户” 👤

解决方案

1. 安装到 C: 盘（Windows）- 避免权限问题
2. 尝试不同浏览器 – Chrome、Edge 或 Firefox
3. 等待高峰期 – 服务器负载可能导致延迟
4. 手动清除认证令牌 – 删除存储的凭据
5. 检查防火墙设置 – 确保 Antigravity 可以访问网络
6. 使用 VPN – 如果地区限制导致问题

“您当前的账户不符合条件”（账户类型）

个人 Gmail 账户 vs 企业 Workspace 账户

Antigravity 目前优先支持个人 Gmail 账户。如果您使用企业 Workspace 账户遇到问题：

1. 切换到个人 Gmail – 使用个人 Google 账户登录
2. 检查管理员设置 – 企业账户可能有访问限制
3. 联系支持 – 如果需要企业账户访问

“您当前的账户不符合条件”（地理限制） 🌍

某些地区可能受到访问限制。如果您遇到地理限制：

1. 检查支持的地区 – 访问官方文档
2. 使用 VPN – 连接到支持的地区
3. 等待扩展 – Antigravity 正在逐步扩大可用性

代理执行错误 ⚠️

模型提供商过载

“模型提供商过载，请稍后重试”

解决方案

1. 等待几分钟 – 高峰期服务器负载高
2. 切换到低级模型 – 使用 Gemini 2 Flash 而非 Gemini 3 Pro
3. 分解任务 – 将大任务拆分为更小的步骤
4. 启用手动审查模式 – 减少自动 API 调用
5. 检查服务状态 – 访问 Google AI 状态页面

浏览器扩展问题 🔌

扩展安装失败

解决方案

1. 手动安装扩展 – 从 Chrome 网上应用店下载
2. 检查浏览器版本 – 确保使用最新版本
3. 禁用其他扩展 – 可能存在冲突
4. 清除浏览器缓存 – 删除临时文件
5. 重启浏览器 – 完全关闭并重新打开

扩展重复下载循环

扩展不断提示重新下载

解决方案

1. 检查扩展权限 – 确保已授予所有必需权限
2. 手动启用扩展 – 在 chrome://extensions 中启用
3. 删除并重新安装 – 完全卸载后重新安装
4. 检查企业策略 – 企业浏览器可能阻止扩展

浏览器控制权限问题

Antigravity 无法控制浏览器

解决方案

1. 授予调试权限 – 允许远程调试
2. 关闭其他 Chrome 实例 – 只保留一个浏览器窗口
3. 检查端口占用 – 确保调试端口未被占用
4. 重启 Antigravity – 重新建立连接

安装问题 📦

Windows 安装问题

解决方案

1. 以管理员身份运行 – 右键点击安装程序
2. 暂时禁用杀毒软件 – 可能阻止安装
3. 检查系统要求 – 最低 8GB RAM，推荐 16GB
4. 安装到 C: 盘 – 避免权限问题
5. 检查磁盘空间 – 确保至少 5GB 可用空间

macOS 安装问题

解决方案

1. 允许未知来源应用 – 系统偏好设置 > 安全性
2. 检查 Rosetta 2（Apple Silicon）- 确保已安装
3. 授予完全磁盘访问权限 – 在隐私设置中
4. 检查 macOS 版本 – 需要 macOS 12 或更高版本

Linux 安装问题

解决方案

1. 安装依赖项 – libgtk-3-0, libnotify4 等
2. 授予执行权限 – chmod +x antigravity.AppImage
3. 检查 FUSE – AppImage 需要 FUSE 支持
4. 使用包管理器 – 尝试 .deb 或 .rpm 包

MCP 服务器问题 🔧

EOF 错误

MCP 服务器返回 EOF 错误

解决方案

1. 重启 MCP 服务器 – 停止并重新启动
2. 检查服务器日志 – 查看具体错误信息
3. 验证配置文件 – 确保 JSON 格式正确
4. 更新 MCP 服务器 – 安装最新版本
5. 检查端口冲突 – 确保端口未被占用

认证缓存问题

需要重置配置文件

解决方案

1. 清除认证缓存 – 删除 ~/.antigravity/auth
2. 重新登录 – 重新进行身份验证
3. 检查令牌过期 – 刷新访问令牌
4. 重置配置 – 删除并重新创建配置文件

常见问题解答（FAQ） 💬

Antigravity 为什么会崩溃？

常见原因：

1. 内存不足 – 需要至少 4GB 可用 RAM
2. 硬件加速冲突 – GPU 驱动问题
3. 扩展冲突 – 浏览器扩展干扰
4. 损坏的缓存 – 临时文件损坏
5. 过时的版本 – 需要更新到最新版本

快速修复： 重启应用 + 清除缓存

如何修复登录循环？

解决步骤：

1. 清除浏览器 Cookie 和缓存
2. 使用隐身模式尝试登录
3. 切换到不同的浏览器
4. 检查是否使用个人 Gmail（非企业账户）
5. 等待 5-10 分钟后重试（服务器负载）

终极方案： 完全卸载 → 删除配置文件 → 重新安装

编码规则（Coding Rules）如何工作？

编码规则为 Antigravity 提供项目特定的上下文和约束。

最佳实践：

1. 保持简洁 – 每条规则 50-200 字
2. 具体明确 – 避免模糊的指令
3. 分类组织 – 按技术栈分组
4. 定期更新 – 随项目演进调整
5. 测试验证 – 确保规则生效

示例： “使用 TypeScript strict 模式，所有函数必须有返回类型注解”

工作流（Workflows）有什么用？

工作流自动化重复性任务，提高开发效率。

常见用例：

1. 代码审查 – 自动检查代码质量
2. 测试生成 – 为新功能生成单元测试
3. 文档更新 – 同步代码和文档
4. 重构任务 – 批量代码重构
5. 部署准备 – 构建和发布检查

创建工作流： 设置 > 工作流 > 新建 > 定义步骤

性能优化建议

减少内存占用

优化策略：

1. 关闭未使用的对话 – 每个对话占用内存
2. 限制上下文长度 – 避免过长的对话历史
3. 定期重启应用 – 清理内存碎片
4. 禁用不必要的扩展 – 减少资源消耗
5. 使用轻量级模型 – Gemini 2 Flash 比 Gemini 3 Pro 更快

提高响应速度

加速技巧：

1. 使用编码规则 – 减少澄清往返
2. 分解复杂任务 – 小任务响应更快
3. 禁用规划模式 – 直接执行简单任务
4. 优化网络连接 – 使用有线连接或稳定 WiFi
5. 关闭实时预览 – 减少渲染开销

调试技巧

查看日志文件

日志位置：

• Windows: %APPDATA%\Antigravity\logs
• macOS: ~/Library/Application Support/Antigravity/logs
• Linux: ~/.config/Antigravity/logs

关键日志：
– main.log – 主进程日志
– renderer.log – 界面渲染日志
– agent.log – 代理执行日志

启用调试模式

启用方法：

1. 打开设置 > 高级
2. 启用”开发者模式”
3. 重启应用
4. 按 Ctrl+Shift+I（Windows/Linux）或 Cmd+Option+I（macOS）打开开发者工具

常见错误代码

推荐 MCP 服务器

MCP（Model Context Protocol）服务器扩展 Antigravity 的能力，连接外部服务和工具。

热门 MCP 服务器

Cloudflare

• 功能: Workers、KV、R2 存储管理
• 用途: 边缘计算和部署
• 安装: npm install @cloudflare/mcp-server

Supabase

• 功能: 数据库管理、认证、存储
• 用途: 后端即服务
• 安装: npm install @supabase/mcp-server

GitHub

• 功能: 仓库管理、PR、Issues
• 用途: 代码协作和版本控制
• 安装: npm install @github/mcp-server

AWS

• 功能: S3、Lambda、DynamoDB 管理
• 用途: 云基础设施操作
• 安装: npm install @aws/mcp-server

Vercel

• 功能: 部署管理、环境变量
• 用途: 前端应用部署
• 安装: npm install @vercel/mcp-server

Neon

• 功能: Serverless Postgres 管理
• 用途: 数据库操作
• 安装: npm install @neon/mcp-server

最佳实践

编写高效提示词

原则：

1. 明确具体 – “重构 UserService.ts 使用依赖注入” 优于 “改进代码”
2. 提供上下文 – 说明项目技术栈和约束条件
3. 分解任务 – 大任务拆分为 3-5 个小步骤
4. 指定输出 – 明确期望的代码风格和格式
5. 迭代优化 – 根据结果调整提示词

示例对比：

❌ 差: “帮我写个登录功能”

✅ 好: “使用 Next.js App Router 和 NextAuth.js 实现 Google OAuth 登录，包含 session 管理和受保护路由”

配置编码规则

推荐结构：

## 技术栈
- Next.js 14 App Router
- TypeScript strict 模式
- Tailwind CSS
- Prisma ORM

## 代码风格
- 使用函数组件和 Hooks
- 优先服务器组件
- 错误边界必须包裹异步组件
- 所有 API 路由返回统一格式

## 禁止事项
- 不使用 class 组件
- 不使用 any 类型
- 不直接操作 DOM

使用工作流自动化

常用工作流模板：

1. 代码审查流程
2. 检查类型安全
3. 验证测试覆盖率
4. 检查性能问题

5. 生成审查报告

6. 测试生成流程

7. 分析函数签名
8. 生成单元测试
9. 生成集成测试

10. 验证测试通过

11. 文档同步流程

12. 扫描代码变更
13. 更新 API 文档
14. 生成变更日志
15. 更新 README

故障排除速查表

获取帮助

官方资源

• 官方文档: https://antigravity.codes/docs
• 故障排除指南: https://antigravity.codes/troubleshooting
• 入门教程: https://antigravity.codes/tutorial
• 社区论坛: https://community.antigravity.codes

报告问题

提交 Bug 报告时请包含：

1. 系统信息 – 操作系统、版本、硬件配置
2. Antigravity 版本 – 帮助 > 关于
3. 重现步骤 – 详细的操作流程
4. 错误信息 – 完整的错误日志
5. 截图/录屏 – 问题的视觉证据

社区支持

• Discord 社区: 实时讨论和快速帮助
• GitHub Issues: 报告 Bug 和功能请求
• Stack Overflow: 标签 antigravity

总结

本指南涵盖了 Antigravity 最常见的故障和解决方案：

✅ 无限加载问题 – 取消操作、检查挂起进程、简化任务
✅ 服务器崩溃 – 重启应用、清除缓存、检查资源
✅ 登录问题 – 切换浏览器、清除令牌、确认账户类型
✅ 代理错误 – 切换模型、分解任务、检查服务状态
✅ 扩展问题 – 手动安装、授予权限、检查冲突
✅ 安装错误 – 管理员运行、检查系统要求、禁用杀毒
✅ MCP 问题 – 重启服务、验证配置、检查日志

核心原则：
1. 遇到问题先重启
2. 检查日志找根因
3. 简化任务降低复杂度
4. 保持软件和系统更新
5. 善用编码规则和工作流

参考链接

• Antigravity 官网
• 官方文档
• 入门教程
• 故障排除原文
• MCP 服务器列表
• 社区论坛

文档版本: 1.0
最后更新: 2025-12-27
翻译: 基于 Antigravity 官方故障排除指南
许可: 仅供学习参考，版权归 Google Antigravity 所有