Git使用git add --patch编辑代码块失败问题求助

先梳理下你的操作过程，方便定位问题：

1. 你将文件中所有的bar替换为bar1
2. 执行git add --patch命令，在编辑第一个代码块时，把自动生成的+bar1改成了+bar2
3. 随后Git返回了错误：

   error: patch fragment without header at line 12: @@ -15,5 +15,5 @@ foo
   Your edited hunk does not apply. Edit again (saying "no" discards!) [y/n]?
   

错误原因 #

这个问题的核心是补丁hunk的上下文匹配逻辑。当你用git add --patch时，Git会根据工作区和暂存区的差异，把修改拆分成多个独立的hunk（代码块）——因为你一次性修改了文件里两个位置的bar，所以Git会生成两个hunk，分别对应开头和末尾的bar修改。

当你只编辑第一个hunk，把+bar1改成+bar2时，这个修改只覆盖了第一个bar的变化，但工作区里第二个bar已经被改成了bar1。Git在验证你编辑后的补丁时，会检查整个补丁是否能无缝应用到当前工作区状态，此时它发现第二个hunk的上下文和预期不符，就会抛出“patch fragment without header”的错误——简单来说，就是你只修改了部分补丁，但剩下的补丁部分已经和当前工作区的状态不匹配了。

解决办法 #

你可以通过两种方式解决这个问题：

方法一：逐个编辑所有相关hunk #

当git add --patch提示你处理第一个hunk时，编辑它并将+bar1改为+bar2，保存退出后，Git会继续询问你是否处理下一个hunk（对应文件末尾的bar修改），选择编辑这个hunk，同样将+bar1改为+bar2。这样所有hunk的修改都和工作区状态匹配，就能成功应用补丁。

方法二：先撤销全局修改，按需手动修改后再打补丁 #

1. 先撤销工作区的全局修改，回到修改前的状态：

   git checkout -- your-file-name
   

2. 手动将文件中需要修改的bar分别改成bar2（比如开头和末尾的bar都改成bar2）
3. 再执行git add --patch，此时每个hunk都是你预期的修改，不会出现验证失败的问题。

另外，你的Git版本2.17.0比较老旧，虽然这个问题的核心逻辑在新版本中没有变化，但升级到较新的Git版本（比如2.30及以上）会得到更清晰的错误提示，能帮你更快定位问题。

内容的提问来源于stack exchange，提问作者Oliver Joseph Ash