git-worktree

Git 多工作区管理

补充说明

git worktree 让同一个仓库同时检出多个目录，共享 .git 对象库。适合一边开发一边 hotfix，或同时构建多个分支，不用反复 stash。

常用示例

git worktree add ../app-hotfix -b hotfix
git worktree add ../app-review origin/main
git worktree list
git worktree remove ../app-hotfix
git worktree prune
git worktree lock ../app-review
git worktree unlock ../app-review
git worktree move ../app-review ../review

易错点与排错

• 同一个分支不能在两个 worktree 同时检出；需要新分支或 detached HEAD。
• worktree 共享对象库和 refs，但各自有独立工作区和索引。
• 删除目录前先 git worktree remove；直接 rm -rf 会留下元数据，用 prune 清理。
• lock 用于移动磁盘或临时保留；忘记解锁会让 prune 跳过它。
• 子模块不会自动在每个 worktree 初始化；需要单独 submodule update。
• 构建缓存、IDE 配置和 node_modules 不共享；多 worktree 会占更多磁盘。
• 删除 worktree 不会删除分支；分支仍留在主仓库。

相关命令

• git — 版本控制
• git-stash — 临时保存改动
• git-submodule — 子模块