手动编辑Git Hunk时如何避免“error: patch fragment without header”错误？

首先，咱们先拆解下你遇到的问题：你手动编辑拆分后的第一个hunk时，没有同步更新hunk的header行（就是@@ -1,8 +1,8 @@那一行），导致Git无法正确识别第二个hunk的位置，从而抛出了patch fragment without header的错误。这不是Git 2.18的bug，是手动编辑hunk时容易忽略的细节。

为什么会出问题？ #

Git的hunk header（@@ ... @@）是用来告诉Git这个patch片段对应原始文件和修改后文件的行范围的：

• -1,8 表示原始文件从第1行开始的8行
• +1,8 表示修改后文件从第1行开始的8行

你编辑后的第一个hunk，实际只修改了bananas和milk两行，但你保留了原来覆盖8行的header。这就导致Git在应用第一个patch时，会把未修改的行（比如apples、yogurt、wheat bread等）也纳入这个hunk的范围，和第二个hunk的行范围重叠，最终Git找不到第二个hunk的正确起始位置，报错。

正确的编辑方式 #

你需要把第一个hunk的header调整为匹配你实际修改的行范围：

@@ -2,4 +2,4 @@
Shopping List
apples
-bananas
+6 bananas
yogurt
-milk
+2% milk

这里的@@ -2,4 +2,4 @@表示：

• 原始文件从第2行开始的4行（对应apples、bananas、yogurt、milk）
• 修改后文件的对应范围也是4行（因为你只是修改内容，没增删行数）

这样调整后，第一个hunk的范围就只包含你实际修改的区域，不会和第二个hunk重叠，Git就能正常解析了。

额外建议 #

1. 如果你觉得手动计算行号麻烦，可以在拆分hunk时更精准一点——拆分的时候就把只需要修改bananas和milk的部分拆成单独的hunk，避免后续手动调整header。
2. Git 2.18确实是比较老旧的版本（2018年发布），更新到较新的版本（比如2.30+）后，不仅会有更清晰的错误提示，对hunk编辑的容错性也会更好，建议升级试试。

内容的提问来源于stack exchange，提问作者12kesselrun