filecmp.cmp() 默认不能直接判断内容相同,因shallow=True仅比大小和修改时间;须显式设shallow=False才逐字节比对,返回True表示字节完全一致(含换行符、BOM等)。

filecmp.cmp() 能否直接判断两个文件内容相同
filecmp.cmp() 是最常用的入口函数,但它默认只比较文件大小和修改时间(shallow=True),**不读取内容**。这意味着两个文件内容不同但大小和时间恰好一致时,它会误判为相同。
实际使用中必须显式传入 shallow=False 才触发逐字节比对:
import filecmp
result = filecmp.cmp('a.txt', 'b.txt', shallow=False)
返回 True 表示内容完全一致(包括换行符、空格、BOM 等所有字节),False 表示存在任意差异。
为什么 filecmp.cmp() 在某些场景下返回 False 却找不到明显区别
常见原因不是逻辑错误,而是文件本身存在隐蔽差异:
立即学习“Python免费学习笔记(深入)”;
- Windows 与 Linux 换行符不同:
\r\nvs\n - UTF-8 文件带 BOM(
\ufeff)而另一个不带 - 末尾有不可见空格或制表符
- 一个文件是文本模式打开写入(自动换行符转换),另一个是二进制模式
此时 filecmp.cmp(..., shallow=False) 严格按字节判断,必然返回 False。如需忽略换行符差异,不能依赖 filecmp,得自己读取后 normalize 再比较。
filecmp.cmpfiles() 适合批量比较多个文件对
当需要一次性比对目录下若干同名文件(例如测试前后输出),用 filecmp.cmpfiles() 更高效:
import filecmp
match, mismatch, errors = filecmp.cmpfiles(
'dir1', 'dir2', ['config.json', 'data.csv', 'log.txt']
)
它返回三个列表:match(内容一致的文件名)、mismatch(内容不一致)、errors(缺失或不可读)。注意:该函数内部也默认使用 shallow=True,同样要加 shallow=False 参数才能保证内容级比对。
大文件比对时 filecmp.cmp() 的内存与性能表现
filecmp.cmp(..., shallow=False) 并非一次性加载整个文件到内存,而是分块读取并实时比对,遇到第一个差异就立即返回 False,因此对超大文件(GB 级)依然可用且内存友好。
但要注意两点:
- 如果两个文件完全相同,它会读完整个文件 —— 此时耗时取决于磁盘 I/O 速度
- 若频繁调用,建议先用
os.path.getsize()快速过滤掉大小不同的文件,避免不必要的读取
真正容易被忽略的是:即使你写了 shallow=False,如果传入的是符号链接且系统未启用 follow_symlinks(Python 3.12+ 默认行为变化),可能意外跳过真实文件比对 —— 务必确认路径指向的是实际文件内容。


















