python-magic是识别真实mime类型的最可靠方案，基于libmagic通过文件头部字节特征匹配，支持from_file和from_buffer两种方式，需注意平台依赖、扫描长度限制及buffer类型要求。
用 python-magic 识别真实 MIME 类型最可靠
仅靠文件扩展名判断格式完全不可信，python-magic 是目前 Python 生态中识别真实 MIME 类型的首选方案。它基于 libmagic（和 Unix file 命令同源），通过读取文件头部字节特征匹配，能准确识别被篡改后缀或无后缀的文件。
安装时注意：Windows 用户需额外安装 libmagic 二进制依赖（推荐用 pip install python-magic-bin）；macOS/Linux 通常只需 pip install python-magic。
- 初始化
magic.Magic实例时，建议显式指定mime=True获取 MIME 字符串，而非默认的描述文本 - 对大文件，传入
param参数限制扫描长度（如magic.from_file(path, mime=True, param={'maxbytes': 4096})），避免卡顿 - 若遇到
OSError: magic_open failed，大概率是 libmagic 数据库路径未正确加载，可手动指定：magic.Magic(mime=True, magic_file='/usr/share/misc/magic.mgc')
magic.from_buffer() 适合内存中数据校验
上传接口或处理流式内容时，常需在不落盘的情况下验证文件类型。此时不能用 from_file()，必须用 from_buffer()，但要注意：它只读取前几 KB，默认最多 1024 字节 —— 某些格式（如 PDF、某些 ZIP 变体）需要更长的 header 才能准确识别。
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
- 务必确保传入的是
bytes，不是str或bytearray（后者可能触发意外解码） - 若 buffer 过短（比如只取了前 100 字节），
from_buffer()可能返回application/octet-stream，这不是错误，而是“无法判断”，需结合业务逻辑决定是否拒绝 - 示例：
magic.from_buffer(b'%PDF-1.4...', mime=True)返回'application/pdf'；而magic.from_buffer(b'GIF87a...', mime=True)返回'image/gif'
别用 imghdr 或 filetype 替代 python-magic
imghdr 仅支持极少数图像格式（GIF/JPEG/PNG 等），且已标记为 deprecated；filetype 库虽轻量，但规则覆盖窄、更新慢，对 Office 文档、PDF、音视频等常见格式识别率低，容易误判为 application/octet-stream。
-
filetype.guess()对加密 ZIP、带元数据的 JPEG、新版 DOCX（实际是 ZIP）基本失效 -
imghdr.what()无法区分 WebP 和 AVIF，也无法识别 HEIC（iOS 默认相册格式） - 两者都不支持自定义 magic 数据库，无法应对私有或新出的格式
识别结果需结合业务做二次过滤
MIME 类型只是线索，不是绝对安全凭证。例如 application/x-executable 可能是合法的 Windows 安装包，也可能是恶意 payload；text/plain 可能是 CSV，也可能是伪装成文本的 PHP 脚本。
- 对上传场景，应白名单限定允许的 MIME（如只接受
image/jpeg、image/png），而非黑名单过滤 - 对 PDF/Office 文件，建议额外调用
pdfid或oletools检查嵌入脚本或可疑对象 - 注意 MIME 的细微差异：
application/vnd.openxmlformats-officedocument.wordprocessingml.document（DOCX）和application/msword（DOC）是不同格式，解析方式完全不同
真正麻烦的不是识别不准，而是识别太准——比如发现一个 .jpg 文件其实是 ELF 可执行文件，这时候该拦还是该报？得看你的系统有没有能力处理这种异常流。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
