用途:本技能是一份 Git worktree 与 gw CLI 的使用指南,帮助在同一仓库上同时检出多个分支、在独立目录中并行开发,避免频繁切换分支打断当前工作。
主要能力:
- gw add:创建 worktree,支持新建分支、指定起点、--force、--detach;可按 .gw/config.json 中 autoCopyFiles 自动复制 .env、密钥、本地配置等。
- gw cd:按完整或部分名称导航到 worktree,依赖安装 gw 时写入的 shell 函数实现目录切换;可用 gw install-shell 重装。
- gw list:列出所有 worktree,显示路径、提交哈希、分支及 detached、locked、prunable 等状态。
- gw sync:从指定 worktree 复制文件,如 gw sync feature-auth .env。
- gw remove、gw prune、gw lock、gw unlock、gw repair:删除、清理失效引用、锁定/解锁与修复。
使用方式:用 gw add 建立工作目录,用 gw cd 进入,在其中独立执行 npm install、npm run dev 等;完成后用 gw remove 清理,手动删除目录后用 gw prune 清理引用。
适用场景:并行功能开发、生产热修复、代码审查、多 Node 版本测试、长期实验分支。
限制:多个 worktree 不能同时检出同一分支;工作目录文件、未跟踪文件、node_modules、构建产物、.env 不共享,需各自安装依赖或手动复制;部分 Git UI 工具对 worktree 支持有限;删除需先 unlock,恢复锁定或损坏状态可用 gw unlock、gw repair 等命令,具体价格或平台信息暂未提供。