Git 2.56 给一个老毛病配了新工具:解决合并冲突时,标记一删就顺手敲 git add .,把工作区里其他乱七八糟的改动一起塞进暂存区。git add --resolved 就是冲着这个来的——它只暂存 Git 仍判定为未合并的路径,并且按设计,只要这些路径里还残留冲突标记,就该拒绝执行。

打开网易新闻 查看精彩图片

有人把 2.56 从源码编译出来,在 Ubuntu 24.04 容器里(仓库里只有 2.43.0)造了一批冲突实测。核心承诺站住了,但外围的安全检查有个没料到的缺口。

先看它做对的部分。测试仓库里两个分支同时改了 file1.txt 和 file2.txt,合并后强制产生冲突,两个文件都正确解决,然后对与合并无关的第三个文件 file4.txt 做了一处无关修改。执行 git add --resolved . 后,git status --short 显示 file1.txt 和 file2.txt 已暂存,而 file4.txt 第一列是空格,说明它一点没被暂存。换成普通的 git add .,三个文件全部进入索引。如果你曾在解决冲突时把半成品或一行 console.log 一起提交,这个失败模式被直接掐掉了。

问题出在第二项承诺上。--resolved 会检查即将暂存的路径里有没有残留的 >>>>>> 行,但它判断的依据只有一条:这个路径此刻在索引里是否处于冲突阶段,而不是文件内容看起来像不像冲突。标记扫描是挂在“文件仍未合并”这个前提上的一道护栏,不是对已跟踪文件做通用标记扫描。

这意味着,只要你跑过任何清掉未合并位的 add/reset 序列——包括讽刺地,第一次成功使用 --resolved 之后再 amend 点别的——安全网就没了。下一次 --resolved 调用会对一个仍带标记的文件静默地什么都不做,既不暂存,也不报错,更不会告诉你它没有执行检查。

另一个缺口是它不看文件内部。测试里解决冲突的同时,在同一文件里多加了一行忘了删的调试语句,git add --resolved . 照单全收。这个标志对“无关”的判定单位是文件,不是行:它能拦住 file4.txt,因为那是另一个路径;它拦不住你留在本该修好的文件中间的调试行。

成本方面,在 3000 个真实冲突文件、全部预先解决的仓库上,各跑五次对比 --resolved 和普通 add,两组分布互相重叠,整张表里最慢的一次(1.4 秒)属于普通 add。在这个规模上,标记检查算不上值得担心的开销。

结论很直接:如果你的合并流程还以 git add . 收尾,换成 git add --resolved 能免费去掉一个真实失败模式,且没有可测量的代价。但别把标记检查当成防止提交破损冲突标记的通用护栏——它只在索引仍认为路径未合并时触发。跑过 reset、中断的 add、重新触碰同一路径的 rebase 之后,提交前自己看一眼文件,因为 --resolved 不会替你抓,也不会告诉你它没抓。