git add -p结合git diff --word-diff报错，如何实现单词级变更高亮？

我明白你想要的效果——在使用git add -p逐个检查代码块时，能看到单词级的变更高亮，而不是默认的整行高亮。之前尝试的命令报错，核心原因是**interactive.diffFilter对输入输出的行对应关系有严格要求**，而直接用git diff当过滤器完全不符合这个规则。

为什么之前的命令会报错？ #

Git的interactive.diffFilter要求：过滤器的输入行数和输出行数必须严格一对一——输入一行，输出一行，不能多也不能少。但你用的git diff（不管带不带--word-diff）会做这些事：

• 它会生成完整的diff头部信息（比如diff --git a/xxx b/xxx、index abc123..def456这类行），而git add -p传给过滤器的只是单个hunk的内容（从@@ ... @@开始的代码块），这直接导致输出行数远多于输入行数。
• 就算你只给它传hunk内容，git diff也会重新解析并生成自己的diff格式，而不是对输入的每一行做转换，自然无法保持行对应关系。

这就是为什么你执行git -c interactive.diffFilter="git diff" add -p也会报错——本质是git diff的输出结构和过滤器要求不匹配，和--word-diff无关。

可行的解决方案：自定义单词diff过滤器 #

要实现单词级高亮，我们需要一个能处理单个hunk、保持行对应关系，同时对变更行做单词级diff的过滤器。你可以按以下步骤操作：

1. 编写过滤器脚本 #

创建一个名为word-diff-filter.pl的文件，内容如下：

#!/usr/bin/env perl
use strict;
use warnings;

my @lines = <>;
my $in_hunk = 0;
my @old_lines;
my @new_lines;

foreach my $line (@lines) {
    # 处理hunk头部行，直接输出
    if ($line =~ /^@@ /) {
        $in_hunk = 1;
        print $line;
        next;
    }
    # 非hunk内容直接输出
    if (!$in_hunk) {
        print $line;
        next;
    }
    # 收集旧行(-开头)和新行(+开头)
    if ($line =~ /^-(.*)/) {
        push @old_lines, $1;
    } elsif ($line =~ /^\+(.*)/) {
        push @new_lines, $1;
    } else {
        # 遇到上下文行，先处理之前收集的旧/新行
        while (@old_lines || @new_lines) {
            my $old = shift @old_lines // '';
            my $new = shift @new_lines // '';
            # 用git diff --word-diff生成单词级差异
            my $diff = `git diff --word-diff=color --no-index <(echo "$old") <(echo "$new")`;
            # 提取并输出带单词高亮的变更行
            if ($diff =~ /^-(.*)/) {
                print "-$1\n";
            }
            if ($diff =~ /^\+(.*)/) {
                print "+$1\n";
            }
        }
        # 输出上下文行
        print $line;
    }
}
# 处理hunk末尾剩余的旧/新行
while (@old_lines || @new_lines) {
    my $old = shift @old_lines // '';
    my $new = shift @new_lines // '';
    my $diff = `git diff --word-diff=color --no-index <(echo "$old") <(echo "$new")`;
    if ($diff =~ /^-(.*)/) {
        print "-$1\n";
    }
    if ($diff =~ /^\+(.*)/) {
        print "+$1\n";
    }
}

2. 给脚本添加执行权限 #

在终端运行：

chmod +x word-diff-filter.pl

3. 使用过滤器执行git add -p #

现在你可以用这个过滤器来实现单词级高亮：

git -c interactive.diffFilter="./word-diff-filter.pl" add -p

这个脚本会：

• 保留原hunk的行结构和上下文行
• 对每个变更的行对（旧行/新行）调用git diff --word-diff=color生成单词级高亮
• 确保输出行数和输入完全一致，符合Git过滤器的要求

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