如何在Python中用mimetypes自动判断文件MIME类型？-Python教程-PHP中文网

mimetypes.guess_type() 经常返回 (none, none) 根本原因是它仅依赖文件扩展名查表，不读取文件内容；对未知扩展名、无扩展名、中文路径或伪造扩展名等情况均失效，需配合 add_type() 或 python-magic 补足。

如何在python中用mimetypes自动判断文件mime类型？

为什么 `mimetypes.guess_type()` 经常返回 `(None, None)`

根本原因是它只查文件扩展名，不读文件内容。比如一个真实是 PNG 的文件，如果叫 report.xyz，mimetypes.guess_type("report.xyz") 就会返回 (None, None)，因为 .xyz 不在内置映射表里。

常见踩坑点：

传入路径含中文或空格时未做 urllib.parse.quote() 处理（虽然多数情况能过，但严格 URL 场景下会出错）
误以为它能识别压缩包内文件类型（它不能，只看最外层扩展名）
对无扩展名文件（如 README、Dockerfile）完全失效

如何让 `mimetypes.guess_type()` 支持自定义扩展名

用 mimetypes.add_type() 注册新映射，且建议在程序启动时一次性注册，避免重复调用：

import mimetypes
mimetypes.add_type('application/vnd.openxmlformats-officedocument.wordprocessingml.document', '.docx')
mimetypes.add_type('text/markdown', '.md')
mimetypes.add_type('application/x-sh', '.sh')

注意：

第二个参数必须带点（'.md' ✅，'md' ❌）
注册后对所有后续 guess_type() 调用生效，包括第三方库间接调用
不支持通配符或正则，只能精确匹配扩展名

什么时候必须放弃 `mimetypes` 改用 `python-magic`

当你要靠文件“内容”判断类型时，mimetypes 就不够用了。典型场景：

上传文件无扩展名（如用户上传的 unknown_file）
扩展名被恶意伪造（photo.jpg.exe 实际是 PE 文件）
需要区分文本编码（UTF-8 vs GBK）或 XML/HTML 子类型

安装和基础用法：

python-script-generator

快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。

下载

pip install python-magic
# Linux/macOS 还需系统级 libmagic（brew install libmagic / apt-get install libmagic1）

简单判断：

import magic
m = magic.Magic(mime=True)
mime_type = m.from_file("/path/to/file")  # 返回类似 'image/png'

注意 Windows 用户可能遇到 DLL 加载失败，优先用 python-magic-bin 替代。

`mimetypes.guess_extension()` 的陷阱与替代方案

这个函数反向查扩展名，但结果不可靠：同一个 MIME 类型可能对应多个扩展名（如 text/plain → .txt 或 .log），而它只返回第一个注册的。

更稳妥的做法：

若需生成下载文件名，优先按业务逻辑定扩展名（如导出 CSV 就用 .csv），别依赖 guess_extension()
若必须动态推断，先用 python-magic 得到准确 MIME，再查自己维护的映射字典
避免用 guess_extension("application/json") 期望得到 .json——它可能返回 .geojson（取决于注册顺序）

真正难的是混合场景：既要快（不用读文件），又要准（绕过扩展名欺骗）。这时候得组合策略——先 guess_type()，失败或存疑时再 fallback 到 python-magic。文件头几个字节的判断逻辑，没人愿意自己写一遍。