文章目录1.简介2.格式3.常用选项4.示例4.1 为现有分支创建 worktree4.2 创建新分支并同时创建 worktree4.3 查看所有 worktree4.4 移除不再需要的 worktree4.5 锁定 worktree防止在 prune 时被清除4.6 清理已删除的 worktree 引用5.小结参考文献1.简介git worktree是 Git 提供的多工作区管理命令允许你一个仓库拥有多个并存的、相互独立的工作目录每个工作区可以检出不同的分支。这些目录共享同一个 Git 仓库即共享.git目录因此你可以在不影响主工作区的情况下并行处理多个分支的任务。2.格式gitworktreeadd[-f][--detach][--checkout][--lock[--reasonstring]][--orphan][(-b|-B)new-branch]path[commit-ish]gitworktree list[-v|--porcelain[-z]]gitworktree lock[--reasonstring]worktreegitworktree moveworktreenew-pathgitworktree prune[-n][-v][--expireexpire]gitworktree remove[-f]worktreegitworktree repair[path…​]gitworktree unlockworktree3.常用选项选项说明add在指定路径创建一个新的 worktree并基于指定分支检出代码。-b 新分支结合add使用创建并检出新的分支作为 worktree。-B 新分支类似-b但会强制重置已存在的分支。--detach让 worktree 处于“分离头指针”状态不关联任何分支。list列出当前所有 worktree 及其路径、分支、提交信息。--porcelain以脚本可读的格式输出list信息适合编程解析。remove删除指定的 worktree同时删除对应的目录。prune清理已被删除但仍残留记录的 worktree 引用。lock/unlock锁定或解锁 worktree防止被误删除或prune。move将 worktree 移动到新目录。repair修复 worktree 的元数据例如迁移仓库路径后。4.示例4.1 为现有分支创建 worktree# 为 main 分支创建一个 worktree存放在 ../project-main 目录gitworktreeadd../project-main main4.2 创建新分支并同时创建 worktree# 创建新分支 feature/new-dashboard并以此创建 worktreegitworktreeadd-bfeature/new-dashboard../project-dashboard main4.3 查看所有 worktreegitworktree list输出示例/path/to/main-project abc1234 [main] /path/to/project-dashboard def5678 [feature/new-dashboard]4.4 移除不再需要的 worktreegitworktree remove../project-feature4.5 锁定 worktree防止在prune时被清除gitworktree lock../project-security--reason正在进行安全审计4.6 清理已删除的 worktree 引用gitworktree prune5.小结git worktree非常适合并行开发、紧急修复、快速切换分支等场景。它与git clone不同所有 worktree 共享同一个.git目录节省磁盘空间且保持引用一致。参考文献Git - git-worktree Documentation