用 git worktree 并行检出分支修紧急 Bug:不 stash 也不打断当前改动
问题场景
你正在 feature/login 上写一半的代码,改了三个文件还没提交;此时线上报出一个必须马上修的 Bug。常见的两种做法各有代价:
git stash:把当前改动压进栈里,修完再 pop。中间一旦切分支、跑构建、忘记 pop,很容易把半成品搞丢或产生冲突。- 再
git clone一份仓库:磁盘和网络成本翻倍,两份仓库的 remote、分支容易慢慢分叉。
git worktree 提供第三种做法:在同一个仓库对象库上挂出多个工作目录,每个工作目录有独立的 HEAD 和索引(index),共享 refs、对象和配置。这样就可以在一个目录继续写功能,在另一个目录里检出紧急分支修 Bug,两边互不干扰。
前置检查
cd ~/work/demo
git status # 确认当前分支与未提交改动
git worktree list # 已有工作树,避免目录重名
worktree 子命令由 Git 2.5 引入,稳定可用请以你本地 git --version 的实际输出为准,本文不假设任何具体版本号。下文路径、邮箱、分支名均为占位值,请按自己的仓库替换。
步骤一:创建工作树并检出紧急分支
cd ~/work/demo
git fetch origin
git worktree add ../demo-hotfix -b hotfix/order-500 origin/main
三个参数的含义:
../demo-hotfix:新工作树的路径。建议放在主仓库的同级目录,不要嵌在仓库内部;-b hotfix/order-500:新建分支名;origin/main:新分支的起点。
如果紧急分支在远端或本地已存在,则去掉 -b,直接写分支名:
git worktree add ../demo-hotfix hotfix/order-500
步骤二:查看工作树列表
git worktree list
输出示例(占位哈希与路径):
/home/dev/work/demo a1b2c3d [feature/login]
/home/dev/work/demo-hotfix 9f8e7d6 [hotfix/order-500]
需要看更多信息可以加 --porcelain -v。要记住一点:所有工作树共享同一个 common dir 里的对象库、refs、hooks 与配置,只有 HEAD、index 和各目录下的文件是各自独立的。
步骤三:在独立目录里修复并提交
cd ../demo-hotfix
# 编辑出问题的文件
git add src/order/service.py
git commit -m "fix: 处理订单金额为空时的空指针"
git push origin hotfix/order-500
在这一步里,~/work/demo 中的未提交改动完全没有被动过,编辑器也可以同时打开两个目录。
步骤四:回到主工作区合并
cd ~/work/demo
git merge --no-ff hotfix/order-500
如果你只想把这一笔修复带到当前分支、不想引入分支历史,可以改用 git cherry-pick <commit>。
注意:合并时 Git 会检查工作区是否干净。如果主工作区的未提交改动和本次合并涉及的文件不重叠,合并可以正常进行;一旦重叠,Git 会直接拒绝并要求你先处理本地改动,这正是它比 stash 更安全的地方。
步骤五:清理工作树
git worktree remove ../demo-hotfix
git worktree prune
git worktree list
remove只接受干净的工作树;若确实有残留改动,需自行确认后再加--force;- 如果目录是被手工
rm -rf删掉的,用prune清理.git/worktrees/下的元数据,建议先git worktree prune --dry-run -v看一遍; - 分支合并完成后可按需删除:
git branch -d hotfix/order-500。
验证:同一分支不能在两处同时检出
在工作树仍然存在时执行:
git worktree add ../demo-dup hotfix/order-500
预期得到类似报错:
fatal: 'hotfix/order-500' is already checked out at '/home/dev/work/demo-hotfix'
这是设计使然:同一分支在任意时刻只对应一份 HEAD 与索引状态,否则两个目录提交时会互相覆盖。确实需要在另一处看同一提交,用分离 HEAD:
git worktree add --detach ../demo-readonly hotfix/order-500
可运行的最小示例
以下脚本在临时目录里从零演示完整流程,不依赖任何远端:
#!/usr/bin/env bash
set -euo pipefail
tmp=$(mktemp -d)
cd "$tmp"
git init -q demo
cd demo
git config user.email "dev@example.com"
git config user.name "dev"
echo "v1" > app.txt
git add app.txt
git commit -qm "init"
git branch -M main
# 模拟当前分支上存在未提交改动
git switch -qc feature/login
echo "wip" >> app.txt
# 1. 独立工作树 + 紧急分支
git worktree add ../demo-hotfix -b hotfix/order-500 main
(cd ../demo-hotfix && echo "hotfix" > fix.txt \
&& git add fix.txt && git commit -qm "fix: 处理空订单金额")
# 2. 查看工作树
git worktree list
# 3. 在主工作区合并
git merge --no-ff hotfix/order-500 -m "merge hotfix/order-500"
# 4. 验证同一分支不能二次检出(预期失败)
git worktree add ../demo-dup hotfix/order-500 \
|| echo "预期失败:该分支已被其他工作树检出"
# 5. 清理
git worktree remove ../demo-hotfix
git worktree prune
git worktree list
rm -rf "$tmp"
运行方式:保存为 worktree-demo.sh 后执行 bash worktree-demo.sh,观察中间输出即可。示例中的 fix.txt 刻意避开了 app.txt,因此主工作区的未提交改动不会阻塞合并。
边界与限制
- 共享 hooks:hooks 位于 common dir,在一个工作树里装上的钩子会对所有工作树生效。
- 子模块需各自初始化:新工作树里要重新
git submodule update --init。 - 不要手工删元数据:
.git/worktrees/下的记录交给remove或prune处理。 - 长期存在的目录:在可移动磁盘等场景可用
git worktree lock防止被误 prune,用完后unlock。 - 路径约定:不要把工作树建在另一个工作树内部;Windows 下建议给含空格路径加引号,统一使用正斜杠。
- 分支占用:主工作树所在分支同样不能再被第二个工作树检出,排查"分支被占用"时先跑
git worktree list。 - 该机制解决的是并行工作目录问题,不替代代码评审、CI 与发布流程;紧急修复同样需要走完整的验证路径。
- 点赞
- 收藏
- 关注作者
评论(0)