如何使用 diff-so-fancy 提高 git diff 的可读性

阅读原始的 Git 差异输出可能令人疲惫。标准输出通常密集，充满了加号和减号，难以快速扫描。如果你经常审查代码变更，提高差异输出的可读性可以节省时间，帮助你更快地发现问题。

在本文中，我们将向你展示如何使用 diff-so-fancy 来提高 Git 差异输出的可读性——这是一个专为让差异输出更易于阅读而设计的工具。

为什么 Git 差异输出的可读性很重要

当你运行 git diff 时，Git 会在行首使用 + 和 - 等符号显示变更。虽然功能齐全，但视觉上可能很刺眼，尤其是对于大型代码变更。

难以阅读的差异输出可能导致漏掉 bug、代码审查变慢以及精神疲劳。改进 Git 显示差异的方式是一个小变化，但对日常生产力有很大的提升。

相关阅读：如何创建和使用 Git 别名加速工作流程

什么是 diff-so-fancy？

diff-so-fancy 是一个小型工具，它接收 Git 差异输出并格式化，以提高可读性。它移除多余的标记，更清晰地突出变更，并重新组织输出结构，使你能更快地审查代码。

主要改进：

• 更清晰的添加和删除
• 突出显示行内变更的单词
• 更整洁的区块头
• 更易于浏览的块分组

如何安装 diff-so-fancy

你可以通过常见的包管理器轻松安装 diff-so-fancy。

在 macOS 上使用 Homebrew：

brew install diff-so-fancy

在 Ubuntu 或基于 Debian 的 Linux 上：

sudo apt install diff-so-fancy

或直接从 GitHub 克隆：

git clone https://github.com/so-fancy/diff-so-fancy.git

安装后确保 diff-so-fancy 在你的系统路径中。

如何配置 Git 使用 diff-so-fancy

安装完成后，你需要告诉 Git 通过 diff-so-fancy 处理差异输出。

使用以下 Git 配置命令进行设置：

git config --global core.pager "diff-so-fancy | less --tabs=4 -RFX"
git config --global interactive.diffFilter "diff-so-fancy --patch"

这个设置：

• 将所有差异输出通过 diff-so-fancy 处理
• 保持颜色输出完整
• 使 less 中的滚动行为干净且响应迅速

如果你更喜欢手动调用，也可以创建一个 Git 别名。例如：

git config --global alias.dsf "!git diff --color | diff-so-fancy"

现在你可以随时运行 git dsf 来查看更美观的差异输出。

前后对比：看到差异

标准 git diff 输出：

- old line of code
+ new line of code

使用 diff-so-fancy 后：

• 只有行内变更的部分被高亮显示
• 文件名和区块头更容易浏览
• 变更的结构以更符合视觉习惯的方式呈现

这有助于你快速理解变更内容，没有多余的干扰。

结论

对日常 Git 工作流程的小改进会随着时间累积效益。使用 diff-so-fancy 配置 Git 可以使差异输出更易读，审查更快速，错误更少。如果你喜欢这个改进，你可能也会对使用 Git URL 快捷方式加速仓库克隆感兴趣。

常见问题

diff-so-fancy 会改变实际的 Git 差异数据吗？

不会。它只改变差异的显示方式。你的 Git 历史和数据保持不变。

如果需要，我可以轻松禁用 diff-so-fancy 吗？

是的。你可以取消设置 Git 配置，或调用 `git --no-pager diff` 临时绕过它。

diff-so-fancy 适用于所有 Git 命令吗？

它主要改进 `git diff` 和 `git log -p` 的输出。其他命令不受影响。