用途:使用 Git worktree 从一个仓库创建多个工作目录,从而同时处理多个分支。适合并行开发多个功能、在评审 PR 时继续其他工作、以及生产热修复与日常开发同时进行。
主要能力:创建工作树(新分支、已有分支或远程分支)、列出、删除和清理工作树,并提供并行开发与 PR 评审的典型流程示例。基本命令包括 git worktree add ../project-feature-x feature-x、git worktree add ../project-hotfix hotfix/urgent-fix、git worktree add ../project-review origin/feature-y;查看用 git worktree list;删除可用 git worktree remove ../project-feature-x 或先 rm -rf 目录再执行 git worktree prune。
使用方式:按需在仓库外相邻目录创建工作树,进入对应目录完成修改、提交与推送,随后回到主目录继续原任务。建议采用清晰命名,如 project-feature-x、project-hotfix、project-review,并定期执行 git worktree list 与 git worktree prune 清理无用或孤立的工作树。
限制与注意:同一分支不能同时在多个工作树中检出;每个工作树需要单独安装 node_modules,并复制 .env 等环境文件;被工作树占用的分支不能直接删除,需先移除工作树。若出现 already checked out 错误,用 git worktree list 确认分支位置;手动删除目录后应执行 git worktree prune 清理登记。