Git worktree 怎么同时打开两个分支而不反复切换
来源:17golang原创
时间:2026-09-08 09:53:37 325浏览 收藏
如果你需要一边修复线上分支、一边继续开发新功能,没必要在同一个目录里反复切换分支。git worktree 会把同一仓库连接到多个工作目录:主目录保留当前分支,再用相邻目录分别打开 hotfix 和 task-docs。关键是先创建、再核对绑定关系,最后用 remove 或 prune 清理,而不是直接删除目录。
最稳妥的做法是:把两个 worktree 放在仓库外侧的相邻目录,用 git worktree list --porcelain 确认每个路径只对应一个分支;临时离线的工作树先 lock,真正不用的工作树再 remove。
- 同一个分支不能在多个工作树中同时检出,误用
-f只会掩盖问题。 - 每个 linked worktree 都有自己的工作目录、
HEAD和 index,修改不会自动混到另一棵树。 - 清理前先看状态;有未提交修改或子模块时,不要直接强制删除。
先把两个分支放进两个工作目录
先进入主工作树,确认它在哪里、当前检出了什么分支。目录建议放在项目同级,例如 ~/work/demo、~/work/demo-hotfix、~/work/demo-task,不要把 linked worktree 放进主项目的子目录,以免备份、构建工具或忽略规则把它再次嵌套扫描。
# 在主工作树中确认当前路径、分支和未提交改动 pwd git status --short git branch --show-current # 已有分支直接建立工作树;路径放在主仓库同级 git worktree add ../demo-hotfix hotfix # 从当前 HEAD 创建新分支,并在新目录中检出它 git worktree add -b task-docs ../demo-task main
第一条 add 适合已经存在的 hotfix 分支;第二条使用 -b 创建新分支。如果目标分支已经在其他 worktree 中检出,Git 会拒绝这次操作,这正是保护机制,不要马上加 -f。

接着在编辑器里按“File > Open Folder”分别打开 demo-hotfix 和 demo-task。判断是否成功的重点不是窗口数量,而是每个窗口底部或源代码管理面板显示的分支不同,并且路径确实不同。
用列表确认路径和分支没有绑错
不要凭目录名猜状态。回到主工作树执行列表命令,再进入两个目录各看一次 status。--porcelain 适合脚本和逐项核对;如果只想快速浏览,也可以先用不带参数的 git worktree list。
# 以稳定字段查看每棵工作树的路径、HEAD 和分支 git worktree list --porcelain # 分别确认两个工作目录确实位于预期分支 git -C ../demo-hotfix branch --show-current git -C ../demo-task branch --show-current git -C ../demo-hotfix status --short git -C ../demo-task status --short
列表中主工作树通常排在前面,后面是 linked worktree。看到 worktree 路径、对应的 HEAD 和 branch 后,再把它们与实际打开的窗口核对。这样可以避免编辑器打开了同名目录、却实际指向另一个分支。
修改隔离和分支复用的两个边界
多个工作树共享仓库对象和普通引用,但各自拥有独立的 HEAD、index 与工作文件。你可以在 demo-hotfix 改修复代码,同时在 demo-task 编写新功能;提交也分别发生在各自当前分支上。
有两个边界要记住:
- 同一分支默认只能由一棵工作树检出。要把
hotfix从主目录移到新目录,先在主目录切换到别的分支,再执行git worktree add ../demo-hotfix hotfix。 - worktree 不是完整的第二份仓库。它共享对象库和引用,删除某个工作树不会删除提交历史;但未提交文件仍属于那个目录,清理前必须自己确认。
查看、锁定与清理工作树
临时工作目录不再使用时,优先用 Git 命令登记清理,而不是在文件管理器里直接拖进废纸篓。干净的工作树可以直接移除;若路径在移动硬盘或网络盘上,短期离线时应先锁定,防止元数据被当作残留记录清理。
# 先预览主仓库记录中可能已经丢失的工作树 git worktree prune --dry-run --verbose # 对暂时离线的路径加锁,并写明原因 git worktree lock --reason "backup-drive" ../demo-task # 确认不再需要且工作区干净后再移除 git -C ../demo-hotfix status --short git worktree remove ../demo-hotfix # 如果目录曾被手工删除,再清理对应的陈旧管理记录 git worktree prune --verbose
remove 默认会拒绝带有未跟踪文件或已修改文件的工作树;这时先进入该目录保存、提交或转移改动。prune --dry-run 只预览,不会删除;确认列表后再去掉 --dry-run。锁定的工作树要先 git worktree unlock,之后才能移动或删除。

常见问题
为什么 add 提示分支已经被其他 worktree 使用?
这是 Git 防止同一分支出现两个独立 index 的保护。先运行 git worktree list 找到占用者,再决定是在原工作树继续开发,还是先切换原分支后重新添加。只有明确知道工作树记录已经失效时,才考虑清理或修复,不要用 -f 绕过提示。
直接删除目录后,为什么 list 里还留着它?
文件目录和仓库里的 worktree 管理记录是两件事。先用 git worktree prune --dry-run --verbose 查看将被清理的记录,确认没有误删路径后,再执行不带 --dry-run 的 prune。今后优先使用 git worktree remove,让 Git 同步完成目录和元数据的收尾。
小结
把不同分支放到相邻目录,是 Git worktree 最实用的使用方式:add 负责建立隔离工作区,list 负责确认绑定,lock 负责保护暂时离线的路径,remove/prune 负责可控清理。只要坚持“先看状态、再处理目录”,就能同时打开两个分支,又不丢未提交修改。
-
146 收藏
-
474 收藏
-
358 收藏
-
158 收藏
-
164 收藏
-
420 收藏
-
439 收藏
-
213 收藏
-
259 收藏
-
480 收藏
-
488 收藏
-
126 收藏
-
108 收藏
-
462 收藏
-
143 收藏
-
222 收藏
-
371 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习