用 diff -u 是最实用、最不容易出错的起点，它提供带上下文的统一格式输出，含明确 +/- 标记，天然兼容 patch；默认格式语义反直觉且不兼容 patch。

直接说结论：用 diff -u 是最实用、最不容易出错的起点，别碰默认输出格式。 默认的 diff 输出（比如 3c3、5a6）语义反直觉、难定位、没法直接喂给 patch，新手一上手就卡在“这到底改了啥”上。

为什么 diff -u 应该是你的默认选项

统一格式（unified diff）把变化前后的上下文一起打出来，一眼就能看出哪几行被改、删、加，而且每行带明确的 + / - 标记。更重要的是，它的输出天然兼容 patch 命令——你今天用它看差异，明天就能直接用它回滚或同步修改。

• diff file1.txt file2.txt 输出的是“正常格式”，3c3 这种写法要查文档才懂，且不带上下文，容易漏判逻辑改动
• diff -u file1.txt file2.txt 输出开头是 @@ -2,4 +2,4 @@，后面跟着前后各 3 行（可调），- 行是原内容，+ 行是新内容
• 如果想多看几行上下文（比如改了函数体，需要看前后声明），加 -U5 或 --unified=5

diff 比较目录时只扫同名文件，递归需显式加 -r

执行 diff dir1 dir2 不会自动进入子目录；它只会列出 dir1/a.txt 和 dir2/a.txt 的差异，再告诉你 Only in dir1: b.txt 或 Only in dir2: c.py。很多人以为“比较目录”就等于“全量比对”，结果漏掉深层改动。

• 要真正递归比对所有嵌套文件，必须加 -r： diff -r dir1 dir2
• 如果目录里有二进制文件（比如图片、编译产物），diff 默认会报 Binary files X and Y differ，加 --text 强制当文本处理（慎用，可能崩终端）
• 想跳过某些子目录（比如 node_modules），不能靠 diff 自身过滤，得结合 find 或用 rsync --itemize-changes 等替代方案

忽略空格、大小写、空白行这些“视觉噪音”要主动开开关

两个文件逻辑完全一致，但一个用了 2 个空格缩进、另一个用 tab，diff 默认会把整行标为不同——这不是你关心的差异。这类干扰项必须靠参数压制，而不是靠肉眼过滤。

• 忽略空格和 tab 差异：diff -b file1 file2
• 忽略空白行（比如日志里一堆空行）：diff -B file1 file2
• 忽略大小写（比如配置项 ENABLE=true vs enable=True）：diff -i file1 file2
• 多个开关可以连写：diff -biB file1 file2，等价于 diff -b -i -B file1 file2

对比结果为空 ≠ 文件完全相同

运行 diff -u a b 没输出，只代表 diff 认为它们“内容一致”，但这个判断基于文本逐行比对。有些差异它根本看不见：

• 文件末尾有没有换行符（\n）：GNU diff 会警告 No newline at end of file，但不影响“无输出”结论
• 行尾是 \r\n 还是 \n：Windows vs Linux 换行符不同，diff 默认不识别，需加 --strip-trailing-cr
• 文件权限、时间戳、硬链接关系：这些元信息 diff 完全不碰，要用 ls -l 或 stat 单独看

真正要确认两个文件字节级一致，用 sha256sum file1 file2 更可靠。而 diff 的价值，从来不是“证明相同”，而是“快速定位哪里不同”。