用 git worktree 并行检出分支修紧急 Bug:不 stash 也不打断当前改动

举报
yd_250998817 发表于 2026/11/18 09:48:22 2026/11/18
【摘要】 线上告警时需要立刻修 Bug,但当前工作区还有未提交改动。本文用 git worktree add 在独立目录检出紧急分支,给出创建、查看、修复合并、remove 与 prune 清理的最小步骤,并验证同一分支无法在两个工作树中同时检出。

问题场景

你正在 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 与发布流程;紧急修复同样需要走完整的验证路径。
【版权声明】本文为华为云社区用户原创内容,未经允许不得转载,如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。