文本对比工具

文本对比工具（diff）是什么？

文本对比工具（diff checker）比较两段文本或代码，并高亮显示新增、删除或修改的内容。开发者每天都在用 diff：审查代码、排查配置改动、比较 API 响应、验证数据迁移，以及在提交前弄清楚自己改了什么。

读懂 diff 是开发者的核心技能。它能把“真正的行为变化”和无害的格式调整区分开，帮你在 200 行代码里找出那一个被改动的字符。一旦熟悉了绿、红、黄的节奏，代码审查就会快很多。

最重要的 diff 有两种：按行对比（哪些行变了）和按词或按字符对比（一行里面什么变了）。好用的对比工具能让你根据比较的是源代码还是段落文字，在两者之间切换。

比较文本时你会学到什么

• 按行对比告诉你改动发生在“哪里”。按词和按字符对比告诉你一行里面改了“什么”。
• 空白字符可能很重要（Markdown、YAML、Python），也可能无关紧要（其他大多数代码），请据此开关“忽略空白”选项。
• 一处看起来很小的差异，如果改的是某个值、条件、路由、环境变量或功能开关，影响可能非常大。
• 两大段内容差别很大时，先排序或规范化。直接比较两个未排序的 JSON 对象，可能会得到满屏的误报。

一步步比较两段文本

1. 1

   粘贴两个版本

   把原始文本放在左边，新版本放在右边。代码、JSON、普通文字、配置文件，什么都可以。

2. 2

   选择按行或按词对比

   源代码或结构化数据用按行对比。比较段落文字、关注措辞时，切换到按词对比。

3. 3

   设置空白和大小写选项

   如果只关心有意义的改动，开启“忽略空白”；比较日志或大小写无关紧要的文本时，开启“忽略大小写”。

4. 4

   阅读带颜色的结果

   删除的内容在左侧显示为红色，新增的内容在右侧显示为绿色。修改过的行通常会以一红一绿的形式并排出现。

5. 5

   反复调整

   编辑任意一侧，diff 会实时更新。在发起合并请求之前，用它整理出一份干净的补丁非常合适。

Diff 颜色和符号速查表

Coddy 文本对比工具使用的约定，git diff、GitHub 和大多数其他 diff 查看器也都这样用。

可以动手试试的 diff 示例

API_TIMEOUT=3000

API_TIMEOUT=30000

{  "id": 42,  "status": "draft",  "published": false}

{  "id": 42,  "status": "published",  "published": true}

function total(items) {  let sum = 0;  for (const i of items) sum += i.price;  return sum;}

function total(items) {  return items.reduce((sum, i) => sum + i.price, 0);}

@@ -1,4 +1,4 @@ function greet(name) {-  return 'Hi ' + name;+  return `Hi ${name}`; }

Diff 的常见错误

• 在空白字符有意义的时候忽略空白。Markdown、YAML 和 Python 都依赖缩进。
• 只看绿色（新增）的行，漏掉了重要的红色（删除）行。
• 以为 diff 干净就说明新版本是对的。diff 只能告诉你“改了什么”，不能告诉你“改得对不对”。
• 比较压缩过的 JSON 和格式化过的代码时，没有先把其中一份规范化。即使数据相同，每一行看起来也都不一样。
• 面对很长的文件，只依赖并排对比而不搜索关键字。两者结合使用：先浏览一遍，再用 Ctrl+F 查找你关心的字段。

文本对比工具常见问题