最直接有效的方式是用 diff -rq dir1 dir2 快速判断差异；需避免直接 diff dir1 dir2 导致卡顿，加 --brief 或 -w/-i 等选项可优化；php 中需用 try/catch 处理异常并用 getrealpath() 和 hash_file('sha256', ...) 提升可靠性。
用 diff 命令快速看两个文件夹结构和内容差异
Linux/macOS 下最直接有效的方式就是命令行 diff，它不依赖 PHP 扩展，结果清晰，还能区分是文件缺失、内容不同还是权限/时间戳变化。
常见错误是直接 diff dir1 dir2，但默认会递归比较所有子目录，遇到符号链接或二进制文件容易卡住或输出乱码。
- 加
-r递归，-q只报告“不同”不显示具体行（适合快速判断）：diff -rq dir1 dir2 - 想看到文本文件具体哪几行不同？去掉
-q，但加--brief避免大文件阻塞：diff -r --brief dir1 dir2 - 忽略空格、大小写、时间戳等干扰项？用
-w（忽略空格）、-i（忽略大小写）、--no-dereference（不跟进符号链接） - Windows 用户可用 Git Bash 或 WSL，原生 cmd/powershell 的
fc不支持递归，基本不可用
PHP 中用 RecursiveDirectoryIterator 遍历对比文件列表
纯 PHP 实现适合嵌入脚本或需要后续处理的场景，但要注意它只比路径和文件名，不自动读取内容——很多人误以为它能“自动发现内容差异”，其实不会。
典型坑是没处理异常：比如权限不足的子目录会抛出 UnexpectedValueException，导致整个遍历中断。
立即学习“PHP免费学习笔记（深入）”；
- 必须用
try/catch包裹迭代器内部的current()调用 - 用
getRealPath()而非getPathname()，避免相对路径干扰比对逻辑 - 注意时区和文件系统大小写敏感性：Linux 下
Readme.md和README.MD是两个文件；macOS 默认不区分大小写，但 APFS 卷可能开启区分，行为不一致 - 示例关键片段：
foreach (new RecursiveIteratorIterator(new RecursiveDirectoryIterator($dir)) as $file) { if ($file->isFile()) { $path = $file->getRealPath(); $rel = str_replace($root . '/', '', $path); $files[$rel] = $file->getSize() . ':' . md5_file($path); } }
md5_file() vs hash_file('sha256', ...)：选哪个校验内容
小文件用 md5_file() 没问题，但大文件（>100MB）会明显拖慢速度，且 MD5 已被证明不安全——不是因为“会被破解”，而是碰撞攻击可行，导致两个不同文件产生相同 MD5，影响比对可信度。
实际项目中更推荐 hash_file('sha256', ...)，性能差距在现代机器上可忽略，且 SHA-256 碰撞成本极高，适合生产环境验证一致性。
-
md5_file()内存占用略低，但仅限于极老 PHP 版本（ - 如果只是检查“是否一样”，用
filesize()+filemtime()组合先过滤，能跳过 90% 以上无需完整哈希的文件 - 别用
file_get_contents()+md5()读全量内容再哈希——会把整个文件加载进内存，大文件直接 OOM
忽略特定文件或目录（如 .git、node_modules）的正确方式
硬编码排除逻辑最容易出错：比如正则写成 /\.git\//，却忘了 RecursiveDirectoryIterator 返回的是对象，不是路径字符串；或者用 strpos() 判断包含 .git，结果把 mygitbackup 也误杀了。
真正可靠的做法是逐级检查 $file->getBasename()，而不是匹配完整路径。
- 在迭代器循环内，用
$file->isDir() && in_array($file->getBasename(), ['.', '..', '.git', 'node_modules'])判断是否跳过 - 不要依赖
glob()或scandir()手动拼接路径，它们不处理符号链接和挂载点边界 - 如果用
symfony/filesystem等组件，注意其Iterator类默认不跳过.git，需显式配置ExcludeAdapter - PHP 8.1+ 可用
RecursiveFilterIterator自定义过滤，但多数情况直接continue更直观
真正麻烦的从来不是“怎么列出来”，而是“哪些该算不同”。比如软链接指向同一文件、时区导致的 filemtime() 偏差、NTFS 和 ext4 对纳秒时间戳的支持差异——这些细节不提前对齐，比出来的“差异”可能全是噪音。
