如何通过索引编辑正确修补Git Hunk？

问题场景 #

使用git add -p拆分hunk后，编辑第二个hunk时出现patch does not apply错误，需要纯Git的正确编辑方法。

复现步骤 #

mkdir test && cd test
git init
# 创建初始文件
cat > sample <<EOD
:host {
    max-width: 20%;
    text-align: center;
    cursor: pointer;

    .svg-game-controller {
        width: 100%;
EOD

git add -A
git commit -m 'first'

# 更新文件内容
cat > sample <<EOD
@import '../svg-icon.scss';

:host {
    @include svg-icon-default-style(20%);

    display: flex;
    flex-direction: column;
    justify-content: space-evenly;
    align-items: center;

    height: 100%;

    .svg-game-controller {
        width: 100%;
EOD

git diff # 查看变更
git add -p # 进入补丁交互模式
# 交互操作：输入s拆分hunk，输入n跳过第一个hunk，输入e编辑第二个hunk

核心规则：Hunk头部的正确含义 #

Hunk头部@@ -a,b +c,d @@的定义是：

• -a,b：原文件中，该hunk从第a行开始，共包含b行（含上下文行和要删除的行）
• +c,d：目标文件中，该hunk应用后从第c行开始，共包含d行（含上下文行和要添加的行）

你之前手动修改头部时错误匹配了行号和行数，导致Git无法定位补丁位置，触发报错。

正确的Hunk编辑操作 #

针对你的需求：仅将:host块内的旧属性替换为@include语句纳入补丁，操作如下：

1. 进入编辑窗口后，保留以下内容，无需手动修改hunk头部（Git会自动计算正确的头部值）：

@@ -1,7 +1,14 @@
 :host {
-    max-width: 20%;
-    text-align: center;
-    cursor: pointer;
+    @include svg-icon-default-style(20%);

     .svg-game-controller {
         width: 100%;

注意：必须保留.svg-game-controller这类上下文行，Git依赖它们定位补丁在原文件中的位置。

2. 若要移除:host块内新增的display/flex-direction等属性，直接删除对应+开头的行即可，无需改动头部。

3. 保存退出后，Git会自动重新计算hunk头部，补丁即可正常应用。

错误原因分析 #

你手动将头部改为-1,7 +3,5时，存在两个问题：

• 目标文件的起始行应为1（未删除文件开头内容），而非3；
• 修改头部破坏了Git的上下文匹配逻辑，导致无法定位补丁位置。

关键总结 #

• 手动编辑hunk时，优先修改内容行（删除+行、将-行改为空格行转为上下文），尽量不要手动修改hunk头部，Git会自动计算正确值；
• 必须保留足够的上下文行，确保Git能准确定位补丁位置；
• 若一定要修改头部，需严格对应原文件和目标文件的行号及行数：
  • -a,b：原文件hunk起始行a，总行数b（上下文+删除行）
  • +c,d：目标文件hunk应用后起始行c，总行数d（上下文+添加行）

内容的提问来源于stack exchange，提问作者cyan-kinesin