Gemini CLI Git Worktree 完整指南3 步让每个并行会话拥有独立代码副本【免费下载链接】awesome-design-systems ⚒ A collection of awesome design systems项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-design-systems同时开多个 Gemini CLI 会话干活时最现实的痛点是它们都读写同一个仓库一个会话在修 bug另一个在开发功能A 未提交的改动会被 B 误读上下文互相污染。实验性功能 Git Worktree 就是为了解决这件事——每个并行会话自动分到一份独立的代码副本和分支改动互不干扰三步就能跑起来。三步跑起来30 秒开启开关并启动隔离 worktree 整个流程就三步。第一步打开实验功能开关。有两种写法任选其一交互式在 CLI 里输入/settings搜索Enable Git Worktrees把它设为true或者直接写进settings.json{ experimental: { worktrees: true } }第二步用--worktree启动支持简写-w。给个名字它就成了目录名和分支名的组成部分gemini --worktree feature-search懒得起名就只敲gemini --worktree它会用时间戳加随机后缀自动生成一个名字。第三步开干。此时 Gemini 已经帮你建好 worktree 并自动切了进去直接在隔离环境里继续任务即可。完事用/quit或CtrlC退出后面会发生什么见下文。为什么需要独立代码副本一分钟看懂 worktree 原理两个会话挤在同一个工作目录除了文件冲突还会让彼此的模型上下文变脏——一个会话改了一半的文件可能被另一个会话当成基线状态读走。Git worktree 的原生能力是创建独立目录每个目录有自己的文件状态和分支但共享同一份仓库历史.git对象库。Gemini CLI 在这层能力上做了自动化封装——启动时自动创建 worktree、自动切进新目录、创建时记录基准提交base SHA、退出时完整保留现场把一串手敲的git worktree命令压缩成一个--worktree标志。细节worktree 落盘在哪、分支怎么命名、重启注意事项 几个约定记下来后面清理和排查会省事目录固定在项目根/.gemini/worktrees/名称分支名固定为worktree-名称不传名称时系统用时间戳加 4 位随机字符生成。一个重点提醒该配置属于Experimental分类、默认关闭且修改后必须重启 CLI 才生效——改完不重启就直接启动开关是不起作用的。另外全新 worktree 是一份干净的代码副本开发环境要你自己初始化JS 项目跑一遍npm install或yarnPython 项目建好虚拟环境再按项目规范构建。会话退出与恢复两条可复制的命令 退出策略只有一条原则全保留。/quit或CtrlC退出后worktree 不会被删除未提交的改动和新分支上的提交都原样留下分支也不会被自动删掉。退出页面会直接打印两条可复制的命令一条恢复会话一条手动清理。恢复工作的样子是cd .gemini/worktrees/feature-search gemini --resume session_id其中session_id就是退出页面上打印的那个会话 ID更多会话管理细节可以看 docs/cli/session-management.md。worktree 攒多了两条命令清理 确定不再需要的会话用原生 git 命令清理分支名遵循worktree-名称约定git worktree remove .gemini/worktrees/feature-search --force git branch -D worktree-feature-search进阶玩法想自定义 worktree 位置和分支名就绕开标志位直接用 git 手动建git worktree add ../project-feature-search -b feature-search cd ../project-feature-search gemini这种建在.gemini/worktrees/之外的 worktree 完全不受 Gemini CLI 管理怎么放、怎么命名都随你。常见坑开关没开就传--worktree会直接报错The --worktree flag is only available when experimental.worktrees is enabled in your settings.每个 worktree 都是独立副本依赖安装、构建脚本都得重跑并行开多个会话前先预留时间。该功能处于活跃开发中行为可能随版本变化动手前建议对照 docs/cli/git-worktrees.md 看最新说明。【免费下载链接】awesome-design-systems ⚒ A collection of awesome design systems项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-design-systems创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考