必须分块读取，推荐8192或65536字节块大小，以rb模式打开文件，循环调用update()，最后用hexdigest()获取32位小写十六进制字符串；校验时需strip().lower()统一格式并做长度校验。
用 hashlib.md5() 读取文件并计算校验和
直接调用 hashlib.md5() 并传入整个文件内容（比如 md5.update(f.read())）在大文件上会爆内存。必须分块读取，常见块大小是 8192 或 65536 字节——既避免频繁系统调用，又不占用过多内存。
实操建议：
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 打开文件用
rb模式，二进制读取才能保证字节一致 - 每次
f.read(chunk_size)，空字符串表示读完，跳出循环 - 别忘了最后调用
md5.hexdigest()获取 32 位小写十六进制字符串
import hashlib
def calc_md5(filepath):
md5 = hashlib.md5()
with open(filepath, "rb") as f:
for chunk in iter(lambda: f.read(8192), b""):
md5.update(chunk)
return md5.hexdigest()
校验时比对字符串要忽略大小写和空白符
用户提供的参考 MD5 值可能来自不同工具：Linux md5sum 输出带空格和路径，Windows PowerShell 的 Get-FileHash 默认输出大写，有些网页表单还带前后空格。直接用 == 比对大概率失败。
实操建议：
- 用
.strip().lower()统一处理参考值和计算值 - 可加长度校验：
len(candidate) != 32直接报错，避免把错误格式当哈希比对 - 不要用
.upper()，因为 RFC 和绝大多数工具默认输出小写
验证失败时别只抛 AssertionError
生产环境里，仅靠 assert calc_md5(f) == expected 不仅无法提供上下文，还会在 -O 模式下被完全移除。出问题时连哪条文件、预期值是多少都看不到。
实操建议：
- 用明确异常，比如
raise ValueError(f"MD5 mismatch for {filepath}: got {actual}, expected {expected}") - 如果批量校验，记录失败项到列表，最后统一打印，别遇到第一个错就中断
- 考虑加个
strict=False参数，允许跳过损坏文件继续处理
注意 Windows 上的换行符和符号链接陷阱
open() 在文本模式下会自动转换 \r\n → \n，但 MD5 必须基于原始字节；符号链接若没设 follow_symlinks=False（默认为 True），os.stat() 可能误判文件大小，但更危险的是：某些备份工具会把符号链接本身当作文件内容来哈希，而 Python 默认跟随链接读目标内容——两边规则不一致就校验不过。
实操建议：
- 始终用
rb模式打开，彻底避开换行符干扰 - 若需校验链接自身（而非目标），用
os.readlink()读路径字符串再哈希，或改用pathlib.Path(filepath).read_bytes()（它不跟随符号链接） - 用
os.path.islink(filepath)提前检测，按策略分支处理
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
