适用范围与准备
适用于 git switch 或 git worktree add 提示某分支已在另一个 worktree 检出。先保留当前未提交内容和完整错误路径。本篇处理同一仓库的多个工作区,不使用强制参数抢占分支,也不清理别人的目录。
先区分原因
多个 worktree 共享仓库对象和分支引用,但各有工作目录、索引与 HEAD。默认保护会阻止同一分支同时在另一个工作区检出,避免两个目录都把自己当成该分支的当前状态。路径暂时离线也不等于工作区可以删除。
按顺序操作
- 在当前仓库运行 git worktree list --porcelain,找到报错分支对应的 worktree 路径,并查看 locked、prunable 等标记。路径中可能含空格,后续传给 git -C 时保留引号。
- 若原路径可访问,用 git -C "原路径" status --short --branch 只读检查。先确认那里有没有用户或其他任务正在工作;不能为了当前任务方便就在那个目录切分支、重置或清理文件。
- 只是想检查该分支内容时,可以进入原工作区只读查看,或者在新的独立路径创建 detached worktree。后者不占用同一分支,但之后若要提交并长期保留工作,应先建立自己的分支。
- 确需独立开发时,用 git worktree add -b 新分支 新路径 起点分支。下面 review-local 和 review-worktree 都是占位选择,名称不能与现有分支、目录冲突;不用 -B 或 --force 覆盖保护。
- 原路径不可用时,先判断是否外接盘未挂载或目录被移动。移动造成的连接问题可按官方 repair 流程修复;prune --dry-run 只能作为检查,不因显示可清理就执行实际清理。
git worktree list --porcelain
git -C "/ABS/PATH/TO/EXISTING-WORKTREE" status --short --branchgit worktree add -b review-local ../review-worktree TARGET_BRANCH怎样确认有效
核对新的 worktree 使用自己的分支,起点提交符合预期,原工作区的分支、HEAD 和未提交文件均未改变。目录创建成功不说明任务之间已完全隔离:共享 Git 配置、引用或外部状态文件仍可能互相影响,应按实际任务继续核对。
无效时恢复与下一步
若不再需要新工作区,先保存其中所有工作,再按官方 worktree remove 流程处理;目录不干净时不要加 --force。原工作区归属不清或路径离线时保留记录,联系负责人确认,不把“无法访问”自动等同于“可删除”。