Antigravity 导入现有项目不用新建工程再搬文件,直接用「打开文件夹」把项目根目录交给它,智能体就能读到现有代码和结构。最常见的新手错误是先建空白项目再手动复制文件,既容易丢配置和 Git 记录,还得多走一圈。
三种打开方式,先对号入座
- 本地已有代码:启动页选「打开文件夹」,选中项目根目录,不要选到父目录或桌面。
- 代码在 GitHub 上:选「克隆 Git 仓库」,填仓库地址,Antigravity 会先拉代码再打开。
- 刚从 VS Code 或 Cursor 过来:首次启动时选导入设置,主题、扩展和快捷键可以一起带过来,编辑习惯不用重练。
- 从 Firebase Studio 迁过来:官方有专门的迁移流程,导出压缩包后在本地解压再打开,复杂项目可以让智能体按官方迁移提示走。
导入之后先做这四件事
- 等它读完项目:智能体要先扫一遍文件结构和函数名,索引没跑完就下任务,回答容易跑偏。
- 看一眼 Git 状态:确认分支和未提交改动都在,改之前先提交一次,方便随时回滚。
- 检查 .gemini 目录:项目级配置存在这里,换电脑要连同这个目录一起拷走,只拷代码会丢会话和规则。
- 先用小任务试手:在对话框里输入 /plan,让智能体先出方案再动手,确认没问题再让它改代码。
容易踩的三个坑
- 别把整个磁盘或父目录当项目打开:智能体会把不相关的文件夹也当成上下文,又慢又容易给错建议。
- 会话不会跟着文件夹走:目前没有官方的会话迁移工具,换路径或换电脑后旧对话不一定能带回来,重要结论先记到文档里。
- 多仓库项目用多文件夹工作区:不同路径的仓库可以各设各的权限,别硬塞进一个根目录。