找到变化的东西：文本Diff指南

某些东西坏了。配置文件看起来一样。除了它不一样——在那500行的某个地方，一个字符改变了。

祝你手动找到它。

Diff工具正是为此而存在。比较两个版本，看看变化了什么。调试时间从几小时降到几秒。

Diff何时拯救你

配置文件。 部署坏了？比较工作配置和当前配置。

代码审查。 这个拉取请求实际改变了什么？

API响应。 为什么相同端点现在返回不同数据？

文档版本。 客户在合同中改变了什么？

阅读Diff输出

大多数diff工具显示：

• 删除的行红色（前缀-）
• 添加的行绿色（前缀+）
• 上下文行未更改，显示周围内容

 function process(data) {
-  return data.toLowerCase();
+  return data.toLowerCase().trim();
 }

一行改变了。旧版本没有trim，新版本有。

并排 vs 统一

统一diff内联显示更改。紧凑，适合小更改。

并排并排显示旧版本和新版本。更好理解较大更改。

根据你比较的内容选择。

字符级Diff

行diff显示哪些行改变了。字符diff显示那些行中确切哪些字符改变了。

对于调试配置，字符级帮助找到：

• 额外空格
• 错误引号（' vs "）
• 不可见字符
• 大小写差异

实用技巧

当空白不重要时去除它。 尾随空格和不同行尾造成噪音。

适当时忽略大小写。 有时"TRUE"和"true"是一样的。

使用上下文。 看到周围行有助于理解更改。

小心diff结构化数据。 JSON和XML在比较前应该格式化相同，否则重新格式化差异会掩盖真正的更改。

常见用例

调试环境差异。 比较staging配置和生产配置。差异通常是bug。

随时间追踪更改。 在更改前后保存版本。Diff告诉你确切做了什么。

验证迁移。 比较迁移前后的数据库转储。意外差异意味着迁移bug。

代码审查。 看看实际在改变什么，而不是作者声称改变了什么。

何时行Diff不够

二进制文件。 Diff工具处理文本。图片、PDF和可执行文件需要专门工具。

语义相同但格式不同。 两个有相同数据但不同格式的JSON文件会显示许多差异。先规范化。

移动的代码。 标准diff分别显示删除和添加。高级工具可以检测移动。

---

Diff是被低估的调试工具。当某些东西"看起来一样"但行为不同时，停止猜测并比较。差异在那里——你只需要看到它。