git worktree add 报“working tree is dirty”是因为主工作区存在未提交修改，Git 为防状态污染而阻止操作；解决方式包括 stash 后添加、--force 跳过检查或清理脏文件。
git worktree add 为什么报错“working tree is dirty”
当你执行 git worktree add 时遇到这个错误，说明当前主工作区有未提交的修改（包括已暂存或未暂存），Git 默认拒绝创建新 worktree，防止状态污染。这不是 bug，是保护机制。
解决方式分两种场景：
- 如果这些修改确实要带到新分支：先
git stash，再git worktree add <path> <branch>，进新目录后git stash pop - 如果只是临时改了点配置或日志文件，不想提交也不愿 stash：加
--force参数（git worktree add --force <path> <branch>），但注意——它不会自动清理脏状态，只跳过检查，后续操作仍可能冲突 - 更稳妥的做法是：用
git status --porcelain确认哪些文件被改了，针对性git checkout -- <file>或git clean -f清理无关文件
多个 worktree 共享同一个 .git 目录，会不会互相干扰
不会。每个 worktree 有独立的 HEAD、index 和工作目录，它们共用一个 .git 目录下的对象库（objects/）和引用（refs/），但各自维护自己的分支检出状态。也就是说：
- 在 worktree A 中切换到
feat/login，不会影响 worktree B 的当前分支 - 在 A 中 commit，B 能立刻看到新 commit（因为 refs 共享），但 B 的工作区不会自动更新，需手动
git checkout或git merge - 删除某个 worktree 用
git worktree remove <path>，它会清理该 worktree 的元信息（记录在.git/worktrees/<name>/），但不碰对象库
唯一要注意的是：不能同时在两个 worktree 中对同一文件做未提交修改，否则切回主目录执行 git status 可能报 “Unmerged paths”，得手动解决。
如何安全地删除一个 worktree（尤其是正在开发中的）
直接 rm -rf 目录会留下残留元数据，下次 git worktree list 还显示它，且可能阻塞新 worktree 创建。必须走 Git 原生流程：
- 确保该 worktree 没有未推送的 commit：进目录运行
git log origin/main..HEAD（假设主远程是origin/main），有输出就得先git push - 退出该 worktree 目录，回到主 repo 或任意其他路径
- 执行
git worktree remove <path>（例如git worktree remove ../my-feature） - 如果提示 “prune required”，说明 worktree 目录已被手动删掉，此时运行
git worktree prune清理记录即可
注意：git worktree remove 不会删除 commit 对象，也不会动远程分支——它只解绑本地目录与分支的映射关系。
worktree 和 git switch -c + git checkout 混用会出什么问题
本质区别在于：worktree 是物理隔离的工作区，而 git switch -c 只是切换当前工作区的分支指针。混用本身不报错，但容易引发误操作：
- 你在 worktree A 中
git switch -c fix/typo，创建了新分支，但这个分支只存在于当前 worktree 的 HEAD；如果另一个 worktree B 正在main上，它看不到这个新分支（除非你git push --set-upstream） - 更危险的是：在主工作区执行
git checkout <commit-hash>进入 detached HEAD，然后git worktree add—— 新 worktree 会基于这个 commit 创建，但它的分支名是空的，后续git branch不显示，容易丢失 - 建议约定：所有长期分支都通过
git checkout -b或git switch -c在主工作区创建并命名；worktree 仅用于“检出已有分支”或“临时调试某次提交”，避免在 worktree 内建分支
worktree 的价值不在分支管理，而在并行验证——比如一边跑 CI 构建（在 build/ worktree），一边改代码（在 src/ worktree），两边互不阻塞。把分支生命周期和工作区生命周期分开，才不容易翻车。
