使用git add --patch时如何让每个hunk都显示当前操作的文件名

方案1：全局配置Git，每个hunk前自动打印当前文件名 #

这是最省心的长期方案，通过自定义diff过滤器实现每个hunk交互提示前输出文件名：

1. 新建名为git-patch-filename-filter的脚本文件，内容如下：

#!/bin/bash
current_file=""
while IFS= read -r line; do
    # 捕获diff行中的文件名
    if [[ $line =~ ^diff\ --git\ a/([^ ]+) ]]; then
        current_file="${BASH_REMATCH[1]}"
        echo "$line"
    # 每个hunk开头插入文件名提示（蓝色高亮）
    elif [[ $line =~ ^@@ ]]; then
        echo -e "\033[1;34m>>> 当前处理文件: $current_file\033[0m"
        echo "$line"
    else
        echo "$line"
    fi
done

2. 给脚本添加执行权限，移动到系统PATH包含的目录下（比如/usr/local/bin）
3. 执行全局配置命令生效：
   git config --global interactive.diffFilter "git-patch-filename-filter"
   配置完成后所有git add --patch操作的每个hunk前都会显示当前文件名，无需手动翻页。

方案2：无需改配置的临时查看方法 #

如果你不想修改全局配置，有两个临时查询的方法：

• 在交互提示符下按g，弹出的hunk列表中会标注每个hunk对应的所属文件名，查看完成按q即可回到之前的操作位置
• 在交互提示符下输入!git diff HEAD --name-only，会列出本次所有有变更的文件列表，看完自动回到交互流程

方案3：指定单文件处理避免混淆 #

如果同时处理的变更文件不多，可以直接在命令中指定要处理的文件，天然就能明确当前操作对象：
git add --patch <目标文件路径>

Git patch模式内置交互命令中文参考：

• y - 暂存当前hunk
• n - 不暂存当前hunk
• q - 退出，不暂存当前hunk和所有剩余hunk
• a - 暂存当前hunk以及当前文件的所有后续hunk
• d - 不暂存当前hunk以及当前文件的所有后续hunk
• g - 选择要跳转的hunk
• / - 搜索匹配给定正则的hunk
• j - 跳过当前hunk，查看下一个未处理的hunk
• J - 跳过当前hunk，查看下一个hunk（无论是否已处理）
• K - 跳过当前hunk，查看上一个hunk
• e - 手动编辑当前hunk
• ? - 打印帮助

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