登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  软件教程

Git worktree 怎么同时打开两个分支而不反复切换

来源:17golang原创

时间:2026-09-08 09:53:37 325浏览 收藏

如果你需要一边修复线上分支、一边继续开发新功能,没必要在同一个目录里反复切换分支。git worktree 会把同一仓库连接到多个工作目录:主目录保留当前分支,再用相邻目录分别打开 hotfixtask-docs。关键是先创建、再核对绑定关系,最后用 removeprune 清理,而不是直接删除目录。

最稳妥的做法是:把两个 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

两个 Git linked worktree 的原创桌面界面状态图
图1:两个 linked worktree 各自绑定一个分支,主工作树无需来回切换。

接着在编辑器里按“File > Open Folder”分别打开 demo-hotfixdemo-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 路径、对应的 HEADbranch 后,再把它们与实际打开的窗口核对。这样可以避免编辑器打开了同名目录、却实际指向另一个分支。

修改隔离和分支复用的两个边界

多个工作树共享仓库对象和普通引用,但各自拥有独立的 HEAD、index 与工作文件。你可以在 demo-hotfix 改修复代码,同时在 demo-task 编写新功能;提交也分别发生在各自当前分支上。

有两个边界要记住:

  1. 同一分支默认只能由一棵工作树检出。要把 hotfix 从主目录移到新目录,先在主目录切换到别的分支,再执行 git worktree add ../demo-hotfix hotfix
  2. 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,之后才能移动或删除。

Git worktree 查看锁定和清理的原创桌面界面状态图
图2:清理前先看列表和锁定状态,避免把仍需保留的工作目录误删。

常见问题

为什么 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 负责可控清理。只要坚持“先看状态、再处理目录”,就能同时打开两个分支,又不丢未提交修改。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>