Gemini CLI Git Worktree 实战:并行会话的独立工作目录指南
Gemini CLI Git Worktree 实战并行会话的独立工作目录指南【免费下载链接】awesome-design-systems ⚒ A collection of awesome design systems项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-design-systems你同时开着两个 Gemini CLI 会话处理同一个仓库A 会话在修登录 bug刚写入一半的未提交改动B 会话却在开发搜索功能把 A 改到一半的文件当基准读取又把自己的改动写回同一份工作区。两边的修改互相污染上下文连构建结果都不可信。Gemini CLI 的实验性功能Git Worktree就是为这类冲突设计的它为每个会话自动分配一个独立的 Git worktree 工作目录——文件与分支各自独立、共享同一份仓库历史worktree 可以理解为同一仓库的第二份检出只是文件状态和分支互不干扰。三步跑通如何开启 Worktrees 配置并启动隔离会话先建立整体印象最小可用路径只有三步每一步的机制细节后文再拆。第 1 步打开实验性开关。Worktrees 默认关闭两种开启方式在 CLI 里执行/settings搜索Enable Git Worktrees置为true或直接写入settings.json{ experimental: { worktrees: true } }该配置项定义在 packages/cli/src/config/settingsSchema.ts约 2234-2243 行归属Experimental分类、默认false、requiresRestart: true。也就是说这是实验性功能且修改开关后必须重启 CLI 才生效改完记得重开进程。第 2 步用--worktree启动隔离会话。gemini --worktree feature-search # 显式命名 gemini -w # 不传名称自动随机生成注意每个新 worktree 都是全新的代码副本进入后需按项目规范初始化环境——npm install、yarn、虚拟环境或标准构建流程。另外开关未启用时传--worktree会直接报错校验逻辑在 packages/cli/src/config/config.ts 第 269-270 行。第 3 步退出后按打印的命令恢复。cd .gemini/worktrees/feature-search gemini --resume session_idsession_id就是退出页打印的那串 ID逐字复制即可。--worktree 命名规则解析目录落盘、分支约定与随机名生成跑通只是第一步接下来拆开看启动时到底发生了什么。目录位置与分支命名约定packages/core/src/services/worktreeService.ts 中createWorktree()第 121-134 行完成核心动作const worktreePath getWorktreePath(projectRoot, name); // 项目根/.gemini/worktrees/名称 const branchName worktree-${name}; await execa(git, [worktree, add, worktreePath, -b, branchName], { cwd: projectRoot, env: getSafeGitEnv(), });即目录固定落在项目根/.gemini/worktrees/名称分支名固定为worktree-名称——后文手动清理命令里的worktree-feature-search正是这个来源。项目根由getProjectRootForWorktree()第 96-115 行解析执行git rev-parse --git-common-dir取.git目录的父目录作为根解析失败则退化为当前工作目录。不传名称时的随机名生成省略名称时setup()用 ISO 时间戳加 4 位随机后缀拼装第 33-42 行if (!worktreeName) { const timestamp new Date().toISOString() .replace(/[:.]/g, -).replace(T, -).replace(Z, ); const randomSuffix Math.random().toString(36).substring(2, 6); worktreeName ${timestamp}-${randomSuffix}; }基准 SHA 记录与防重入守卫创建前会先用git rev-parse HEAD抓取基准提交baseSha与名称、路径一起组成WorktreeInfo { name, path, baseSha }返回——这是后续判断worktree 里有没有产生过改动的依据。CLI 入口侧packages/cli/src/gemini.tsx第 380-388 行在启动早期调用 packages/cli/src/utils/worktreeSetup.ts 的setupWorktree()并用性能分析器打点setup_worktree。该函数内部有防重入守卫if (process.env[GEMINI_CLI_WORKTREE_HANDLED] 1) { return undefined; } ... process.chdir(worktreeInfo.path); process.env[GEMINI_CLI_WORKTREE_HANDLED] 1;worktree 创建成功后立即chdir切入新目录并置位环境变量确保 CLI 因自身目的重新拉起进程时不会在 worktree 里再嵌套创建一层。对应测试见 packages/cli/src/utils/worktreeSetup.test.ts。Worktree 会话退出策略现场完整保留与 --resume 恢复那会话结束后呢Gemini 会把目录清掉保持干净吗当前版本的答案是全部保留。worktree 不删除修改过的文件、已暂存改动、未跟踪文件以及新分支上的提交原样留存分支不自动删除worktree 与分支都由你自行清理退出时打印两条指令如何恢复工作、如何手动删除。提示语实现位于 packages/cli/src/ui/components/SessionSummaryDisplay.tsx第 39-43 行存在 worktree 信息时页脚被替换为footer To resume work in this worktree: cd ${escapeShellArg(worktreeSettings.path, shell)} gemini --resume ${footerSessionId}\n To remove manually: git worktree remove ${escapeShellArg(worktreeSettings.path, shell)};两条命令可直接复制执行路径与会话 ID 会按当前 shell 转义渲染验证见 packages/cli/src/ui/components/SessionSummaryDisplay.test.tsx第 199-218 行。值得注意的是核心层其实已具备更完整的条件清理能力hasWorktreeChanges()worktreeService.ts 第 151-184 行先用git status --porcelain检查未提交改动再比较HEAD是否偏离基准 SHA任何 git 命令失败时保守判定为有改动防止误删用户工作maybeCleanup()第 62-84 行在无改动时自动执行git worktree remove --force加git branch -D有改动则保留。但在当前版本里maybeCleanup的调用方主要是 packages/core/src/services/worktreeService.test.ts 中的单元测试第 271-304 行CLI 退出路径仍遵循不自动删除——条件自动清理属于该实验性功能的演进方向。进阶控制手动 git worktree 命令与自动托管边界默认的落盘位置和命名不合意或需要清理被保留的 worktree 时可以直接用原生 Git 命令接管。手动创建任意目录、任意分支名git worktree add ../project-feature-search -b feature-search cd ../project-feature-search gemini清理保留的 worktree分支名遵循worktree-名称约定git worktree remove .gemini/worktrees/feature-search --force git branch -D worktree-feature-search两条路径的差异对比维度Gemini 托管 worktree手动创建 worktree目录位置固定.gemini/worktrees/名称任意分支名固定worktree-名称任意启动行为自动 chdir、记录基准 SHA、退出提示不介入按普通项目使用清理方式退出提示 手动命令手动命令托管边界由 worktreeService.ts 中的isGeminiWorktree()第 136-149 行划定通过realpath比对判断目录是否位于.gemini/worktrees/之下只有 Gemini 托管的 worktree 才走自动管理逻辑你手动放在别处的完全不受干预。此外该功能的所有 git 子进程都经由getSafeGitEnv()见 packages/core/src/utils/gitUtils.ts构造安全环境变量执行宿主机上异常的 git 配置不会干扰 worktree 操作。速查表Gemini CLI Git Worktree 场景 → 命令/配置场景命令 / 配置开启功能需重启/settings搜索 Enable Git Worktrees 置true或settings.json写{experimental: {worktrees: true}}命名启动gemini --worktree feature-search简写-w随机名启动gemini --worktree确认目录与分支.gemini/worktrees/名称分支worktree-名称退出后恢复会话cd .gemini/worktrees/名称 gemini --resume session_id清理 worktreegit worktree remove 路径 --forcegit branch -D worktree-名称自定义 worktreegit worktree add 目录 -b 分支cd 目录 gemini相关文档与源码路径内容路径官方 worktree 文档docs/cli/git-worktrees.md核心服务创建/改动检测/清理packages/core/src/services/worktreeService.ts核心服务单元测试packages/core/src/services/worktreeService.test.tsCLI 启动期 worktree 装配packages/cli/src/utils/worktreeSetup.ts配置项定义packages/cli/src/config/settingsSchema.ts命令行参数解析与校验packages/cli/src/config/config.ts退出提示恢复/清理指令packages/cli/src/ui/components/SessionSummaryDisplay.tsx设置参考docs/cli/settings.md会话管理docs/cli/session-management.md一句话收束开关打开后--worktree起跑退出时照着打印的两条命令恢复或清理——Gemini CLI Git Worktree 的并行会话隔离就这么简单。【免费下载链接】awesome-design-systems ⚒ A collection of awesome design systems项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-design-systems创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

Flash-Attention GQA 批量大小调优实战:为什么批量从 64 加到 256 反而变慢

Flash-Attention GQA 批量大小调优实战:为什么批量从 64 加到 256 反而变慢

Flash-Attention GQA 批量大小调优实战:为什么批量从 64 加到 256 反而变慢 【免费下载链接】flash-attention Fast and memory-efficient exact attention 项目地址: https://gitcode.com/GitHub_Trending/fl/flash-attention 推理服务变慢时,第…

2026/11/16 8:11:16 阅读更多 →
SpringBoot3+Vue3+MySQL校园旧书交易漂流系统全栈实战

SpringBoot3+Vue3+MySQL校园旧书交易漂流系统全栈实战

这次我们来看一个校园旧书交易与漂流场景的全栈项目。核心诉求不复杂:学生手里有不再使用的教材、专业书、小说,放在系统里展示;其他同学可以搜索、收藏、申请交易,或者发起“漂流”,让书在校园内按标记的轨迹继续流动…

2026/10/24 12:45:05 阅读更多 →
SpringBoot3+Vue3校园旧书漂流系统:状态流转与预约并发实现

SpringBoot3+Vue3校园旧书漂流系统:状态流转与预约并发实现

校园旧书漂流交易系统,放在 Java 技术栈里最典型的实现是:SpringBoot3 提供后端接口,Vue.js3 提供前端页面,MySQL 负责把用户、书本和订单记录持久化。这个题目真正值得做的点,不是把增删改查写完,而是让一…

2026/10/25 7:30:23 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/15 5:13:35 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/16 6:41:34 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/15 5:13:35 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/15 3:37:41 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/16 7:30:18 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/15 5:13:35 阅读更多 →

日新闻

周新闻

月新闻