如何让git add --patch自动跳过所有单行变更？

我前阵子刚遇到一模一样的糟心事！Postman这个更新真的太坑了，每次导出全是GUID变更，diff里几百行没用的内容，代码评审和rebase都快疯了。不过我们可以用一个自定义脚本+Git命令组合来自动过滤这些无意义的单行变更，只处理真正有价值的修改，下面是具体步骤：

1. 编写GUID过滤脚本 #

首先写一个Python脚本（也可以用Shell/jq，但Python处理JSON行更灵活），用来过滤掉那些只有GUID变更的diff hunk。创建文件filter-postman-guids.py，内容如下：

#!/usr/bin/env python3
import sys
import re

# 匹配Postman的GUID字段行（适配常见的JSON格式）
guid_line_pattern = re.compile(r'^\s*"id":\s*"[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}"\s*,?$')

def is_guid_line(line):
    return guid_line_pattern.match(line) is not None

def process_hunk(hunk_lines):
    # 拆分hunk头部和变更内容
    header = []
    changes = []
    in_header = True
    for line in hunk_lines:
        if in_header:
            header.append(line)
            if line.startswith('@@'):
                in_header = False
        else:
            changes.append(line)
    
    # 检查当前hunk是否包含非GUID的有效变更
    has_valid_change = False
    # 成对处理删除/新增行
    i = 0
    while i < len(changes):
        if changes[i].startswith('-'):
            if i+1 < len(changes) and changes[i+1].startswith('+'):
                # 对比前后行，去掉GUID后内容是否一致
                old_clean = re.sub(r'"[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}"', '', changes[i][1:].strip())
                new_clean = re.sub(r'"[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}"', '', changes[i+1][1:].strip())
                if old_clean != new_clean:
                    has_valid_change = True
                    break
                i += 2
            else:
                # 单独的删除行，如果不是GUID行则算有效变更
                if not is_guid_line(changes[i][1:]):
                    has_valid_change = True
                i += 1
        elif changes[i].startswith('+'):
            # 单独的新增行，如果不是GUID行则算有效变更
            if not is_guid_line(changes[i][1:]):
                has_valid_change = True
            i += 1
        else:
            # 上下文行，跳过
            i += 1
    
    # 保留包含有效变更的hunk，否则丢弃
    return header + changes if has_valid_change else []

def main():
    # 从标准输入读取Git diff内容，按hunk分割处理
    lines = [line.rstrip('\n') for line in sys.stdin]
    hunks = []
    current_hunk = []
    for line in lines:
        if line.startswith('diff --git'):
            if current_hunk:
                hunks.append(current_hunk)
                current_hunk = []
            current_hunk.append(line)
        elif current_hunk:
            current_hunk.append(line)
    if current_hunk:
        hunks.append(current_hunk)
    
    # 处理所有hunk并输出结果
    output = []
    for hunk in hunks:
        processed = process_hunk(hunk)
        if processed:
            output.extend(processed)
            output.append('')
    
    print('\n'.join(output))

if __name__ == '__main__':
    main()

给脚本添加执行权限：

chmod +x filter-postman-guids.py

2. 集成到Git工作流 #

现在可以用这个脚本快速过滤diff并暂存有效变更，推荐两种方式：

方式一：临时过滤并暂存 #

先查看过滤后的diff确认没问题：

git diff --patch | ./filter-postman-guids.py

如果结果符合预期，直接暂存这些变更：

git diff --patch | ./filter-postman-guids.py > /tmp/meaningful.diff && git apply --cached /tmp/meaningful.diff && rm /tmp/meaningful.diff

方式二：添加Git别名简化操作 #

编辑你的.gitconfig文件（在项目根目录的.git/config或者用户目录的~/.gitconfig），添加一个别名：

[alias]
add-postman = !git diff --patch | ./filter-postman-guids.py > /tmp/meaningful.diff && git apply --cached /tmp/meaningful.diff && rm /tmp/meaningful.diff

之后每次只需要执行：

git add-postman

就能自动过滤GUID变更，只暂存有意义的修改了！

注意事项 #

• 脚本的正则表达式可能需要根据你们Postman导出的JSON格式微调（比如有些行可能没有结尾逗号，或者引号格式不同），可以先测试diff过滤结果再调整。
• 如果有批量的GUID变更但无其他内容修改，脚本会自动忽略这些hunk，不会出现在暂存记录里。
• 执行前建议先运行过滤命令查看结果，确保没有漏掉重要的变更。

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