Git rerere 实战:自动复用冲突解决方案
问题场景
在多人协作仓库中,同一段代码可能在多个分支被反复修改到同一行。合并或变基时,Git 每次都会抛出相同冲突,开发者重复手工选择同一方案。Git 的 rerere(reuse recorded resolution)可以把一次冲突解决记录到本地,后续遇到相同冲突块时自动套用。
开启配置
可以全局开启,也可以只在当前仓库开启。示例用仓库级配置,便于隔离实验:
git config rerere.enabled true
git config rerere.autoupdate true
rerere.enabled 打开记录与复用;rerere.autoupdate 让自动解决后的文件直接进入暂存区。它不会替你提交合并,最终仍需检查并提交。
最小冲突演练
下面从空目录创建演示仓库,让两个分支修改同一行,制造可重复的冲突:
mkdir rerere-demo
cd rerere-demo
git init
git config user.name DemoUser
git config user.email demo@example.com
git config rerere.enabled true
git config rerere.autoupdate true
git branch -M main
cat > app.txt <<'EOF'
line1
shared
line3
EOF
git add app.txt
git commit -m 'base'
git checkout -b feature-a
cat > app.txt <<'EOF'
line1
A change
line3
EOF
git commit -am 'feature-a'
git checkout main
git checkout -b feature-b
cat > app.txt <<'EOF'
line1
B change
line3
EOF
git commit -am 'feature-b'
git checkout main
git merge feature-a
git merge feature-b
第一次合并 feature-a 通常是快进;第二次合并 feature-b 会出现冲突。此时编辑 app.txt 为最终内容,例如:
cat > app.txt <<'EOF'
line1
A+B change
line3
EOF
git add app.txt
git commit -m 'merge feature-b and resolve conflict'
提交后,rerere 已在 .git/rr-cache 中记录冲突前的形状和解决后的形状。可以用 ls .git/rr-cache 观察本地缓存目录。
验证自动复用
为了重演相同冲突,把本地 main 退回合并提交之前,再执行一次同样的合并:
git reset --hard HEAD^
git merge feature-b
git status --short
git diff --cached
第二次合并时,Git 应提示 Resolved 'app.txt' using previous resolution.,说明复用了上次记录。git status --short 中不应再出现 UU app.txt;由于示例开启了 autoupdate,解决结果已在暂存区,git diff --cached 可检查内容是否为 A+B change。确认无误后执行 git commit -m 'merge feature-b again' 完成合并。
在冲突未自动暂存时,可以用 git rerere status 查看 rerere 跟踪的冲突文件,用 git rerere diff 查看当前解决结果与冲突原始内容的差异。rebase 场景同理:自动解决后检查文件,开启 autoupdate 时直接 git rebase --continue;否则先 git add 再继续。
注意:git reset --hard HEAD^ 会丢弃工作区未提交改动,只应在演练仓库使用。
边界与限制
- rerere 只复用文本冲突块;二进制文件冲突不适用。
- 匹配依赖冲突块的上下文。周围行、缩进、冲突标记或合并方向变化后,冲突块可能不同,旧方案不会套用。
- 自动套用不理解语义,旧方案可能不再正确。合并或变基后必须检查 diff 并运行测试。
- 解决策略变化时,用
git rerere forget app.txt清除该路径的当前记录,再重新解决。 .git/rr-cache默认只在本地,不随 push/clone 传输。团队共享缓存要谨慎,避免传播错误解决。rerere.autoupdate只自动暂存,不自动提交;rebase 中仍需继续流程。- 不要把
.git/rr-cache提交到仓库,也不要在未确认内容时盲目接受自动解决。
小结
rerere 适合重复冲突的机械复用,能减少手工操作,但不是语义合并工具。开启 rerere.enabled 和 rerere.autoupdate 后,仍要审查自动解决结果、跑测试,并在策略变化时用 forget 清理记录。
- 点赞
- 收藏
- 关注作者
评论(0)