Git配置文件行过滤异常：diff显示全文件删除如何排查？

问题现象 #

使用Git跟踪配置文件时，为了隐藏主题切换脚本（switch_theme.sh）修改的set background行，配置了.gitattributes和clean/smudge过滤器，但执行git diff -- .config/vim/vimrc时，diff显示该文件所有行被删除，本地文件对应空文件哈希e69de29。

错误原因 #

核心是对Git过滤器的工作逻辑理解错误：
Git的clean/smudge过滤器是管道式内容处理，而非直接修改本地文件：

• clean过滤器：Git将本地文件内容通过管道传给脚本，脚本处理后的输出会被存入Git仓库，而非直接修改本地文件。
• smudge过滤器：Git将仓库中的文件内容通过管道传给脚本，脚本输出内容会写入本地工作区文件。

你的clean脚本犯了两个关键错误：

1. 使用sed -i直接修改本地文件，而非处理管道输入并输出结果；
2. 脚本没有向标准输出任何内容，导致Git认为处理后的文件是空的，diff时就会显示本地文件相对于仓库版本全量删除。

修复方案 #

1. 修正过滤器脚本逻辑 #

替换git_theme_filter.sh内容为以下版本，改为管道式处理内容：

#!/bin/bash

# 处理clean阶段：将主题行替换为占位符，输出到stdout
clean() {
    local filename="$GIT_FILTER_FILENAME"
    # 根据文件名匹配对应处理规则
    case "$filename" in
        *.config/vim/vimrc)
            sed -E "s/^set background=.*/set background=THEME_PLACEHOLDER/g"
            ;;
        # 可以添加其他文件的处理规则
        *)
            # 默认直接输出原内容
            cat
            ;;
    esac
}

# 处理smudge阶段：将占位符替换为实际主题配置，输出到stdout
smudge() {
    local filename="$GIT_FILTER_FILENAME"
    # 获取当前主题（这里假设默认用dark，可根据实际逻辑调整，比如从switch_theme.sh获取）
    local theme="dark"
    # local theme=$("$HOME/bin/switch_theme.sh" current)

    case "$filename" in
        *.config/vim/vimrc)
            sed -E "s/^set background=THEME_PLACEHOLDER/set background=$theme/g"
            ;;
        *)
            cat
            ;;
    esac
}

# 分发命令
case "$1" in
    clean) clean ;;
    smudge) smudge ;;
    *) echo "Usage: $0 {clean|smudge}" >&2; exit 1 ;;
esac

2. 重新应用过滤器 #

执行以下命令让Git重新处理文件：

# 让smudge重新处理本地文件
git checkout -- .config/vim/vimrc
# 让clean重新处理文件并准备提交
git add .config/vim/vimrc

3. 验证修复 #

修改.vimrc中的set background为light，执行git diff -- .config/vim/vimrc，此时该主题行的变更不会出现在diff中，其他内容的变更会正常显示。

注意事项 #

• 过滤器脚本必须是纯内容处理：只处理管道输入的内容，输出到标准输出，禁止直接修改本地文件；
• Git会通过环境变量GIT_FILTER_FILENAME传递当前处理的文件名，可据此为不同文件设置不同处理规则；
• 如果需要多文件批量处理，只需在.gitattributes中为每个文件添加filter=ignore-theme规则即可，脚本会逐个处理。

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