“archive is corrupt”或“invalid magic number”错误90%源于下载文件字节不完整，需先比对官网标注大小，再用certutil -hashfile file.exe MD5逐字符校验MD5值，文本模式读取或第三方工具会导致校验失真。
archive is corrupt 或 invalid magic number 这类错误，90% 以上不是安装过程出错，而是下载的安装包本身字节不完整——校验失败是结果，不是原因。直接重装没用，必须先确认文件是否真实损坏。
校验前先看文件大小是否匹配官网标注
官方发布页（如 python.org/downloads/release/python-3129/）会明确写出 python-3.12.9-amd64.exe 的字节数（比如 28,567,123）。这个数字比哈希值更早暴露问题：
- 用
ls -l python-*.exe（Linux/macOS）或dir python-*.exe（Windows cmd）查实际大小 - 不一致？说明下载中断、代理截断或杀毒软件静默拦截，哈希校验不用做了，直接重下
- 一致？才进入哈希比对环节，避免浪费时间在“看起来正常实则损坏”的文件上
Windows 下用 certutil 校验 MD5 必须加 -hashfile 参数
很多人输错命令导致校验对象错误，比如写成 certutil -MD5 file.exe ——这会报错或返回随机值。正确命令只有一条：
certutil -hashfile python-3.12.9-amd64.exe MD5
输出是 32 位十六进制字符串，需逐字符比对官网右侧的 MD5 值（注意：不是 SHA256）：
立即学习“Python免费学习笔记（深入）”；
- 大小写不敏感，但空格、换行、末尾回车都不能多
- 某些浏览器复制时会带不可见的零宽空格（U+200B），粘贴到记事本再手动清空前后空格再比对
- 别用第三方“MD5 工具”——很多 GUI 工具默认以文本模式读取，会悄悄转换换行符或跳过 BOM，结果必然错
Python 脚本算 MD5 时必须用 'rb' 模式读文件
下面这段代码看似合理，实则必错：
with open('python-3.12.9-amd64.exe', 'r') as f: # ❌ 文本模式！
data = f.read()
hashlib.md5(data.encode()).hexdigest()真正可靠的写法只有这一种：
import hashlib
with open('python-3.12.9-amd64.exe', 'rb') as f: # ✅ 二进制模式
data = f.read()
print(hashlib.md5(data).hexdigest())-
'r'模式会触发系统默认编码（如 cp1252）解码，遇到非文本字节直接抛异常或静默替换，哈希值完全失真 - 即使没报错，Windows 上的
\r\n也可能被误处理，尤其当文件被 Git 自动换行转换过 - 别信“我用记事本打开过，能显示”，那是渲染层的事，和原始字节无关
校验通过但安装仍失败？检查解压工具而非安装包
如果 certutil 和官网 MD5 完全一致，却双击时报 setup failed 或 cannot extract files，问题大概率在解压环节：
- Windows 文件资源管理器自带的“右键 → 提取全部”对 Python 的 NSIS 打包格式支持极差，尤其大体积 EXE
- 旧版 7-Zip（7z x 解压会报错，但
7z l列目录是安全的 - 正确做法：直接双击运行
python-*.exe，让安装程序自己解压；不要试图“先解压再安装” - 企业环境若被策略禁用 EXE 执行，改用 Microsoft Store 版 Python，它绕过本地下载和解压流程
最常被忽略的一点：校验和本身也分版本。Python 3.12+ 官网已全面切换为 SHA256，但很多人还在拿旧文档里的 MD5 值去比——核对前务必确认你查的是当前下载页右侧对应算法那一栏，不是搜索引擎快照或缓存页面。
