Python mimetypes 的双返回值：文件是 CSV，为什么第二项还会出现 gzip
导出系统准备发送report.csv.gz，类型推断返回text/csv和gzip。若把这两项都当作媒体类型，或者看见gzip就把内容改成普通CSV发送，响应头与实际字节就会不一致。mimetypes返回的是两种元数据：内容对应哪类媒体，以及文件名是否表示外层编码。
本文在Linux、CPython 3.12.14实跑，使用该版本的guess_type接口。保存为demo.py后运行python3 demo.py。示例创建独立MimeTypes对象，其推断映射来自内置表，未给它加载额外映射文件；不读取待判断文件的内容，不创建文件，也不发送HTTP响应。Python 3.13起另有guess_file_type用于文件路径，新项目应按所用版本选择接口。
AI生成的概念示意图：内层文档与外层包装分别连着标签，对应媒体类型与内容编码；不是文件真实性检测结果。
完整程序与本次实跑
完整可运行程序
import mimetypes
mimetypes.init(files=[])
db = mimetypes.MimeTypes(filenames=())
names = ["report.csv", "report.csv.gz", "report.CSV", "report.csv.GZ"]
expected = [("text/csv", None), ("text/csv", "gzip"),
("text/csv", None), (None, None)]
for name, wanted in zip(names, expected, strict=True):
found = db.guess_type(name)
assert found == wanted
print(name, "->", found)
media_type, content_encoding = db.guess_type("report.csv.gz")
headers = {"Content-Type": media_type or "application/octet-stream"}
if content_encoding is not None:
headers["Content-Encoding"] = content_encoding
print("candidate headers:", headers)
print("unknown:", db.guess_type("report.yunque-demo"))
db.add_type("application/x-yunque-demo", ".yunque-demo", strict=False)
assert db.guess_type("report.yunque-demo", strict=True) == (None, None)
assert db.guess_type("report.yunque-demo", strict=False)[0] == "application/x-yunque-demo"
print("custom strict:", db.guess_type("report.yunque-demo", strict=True))
print("custom loose:", db.guess_type("report.yunque-demo", strict=False))本次实际输出（以下为结果，不是程序）
report.csv -> ('text/csv', None)
report.csv.gz -> ('text/csv', 'gzip')
report.CSV -> ('text/csv', None)
report.csv.GZ -> (None, None)
candidate headers: {'Content-Type': 'text/csv', 'Content-Encoding': 'gzip'}
unknown: (None, None)
custom strict: (None, None)
custom loose: ('application/x-yunque-demo', None)两项分别描述内层内容与外层编码
report.csv返回text/csv与None，report.csv.gz则返回text/csv与gzip。内层仍被命名为CSV，末尾gz提供了压缩编码线索。程序据此构造候选Content-Type和Content-Encoding，帮助看清两项各应进入哪一个HTTP头。
这里的候选两个字很重要：只有实际发送的内容确实经过gzip编码时，Content-Encoding才应该声明gzip。如果应用先解压再发送，编码头也必须随发送字节调整。后缀映射函数不会代替调用方读取数据，更不会确认压缩内容能成功解码。
大小写规则并不完全一致
report.CSV仍得到text/csv，说明媒体类型后缀可以通过不区分大小写的回退找到映射。report.csv.GZ却返回两个None：编码后缀区分大小写，不能把大写GZ当作已知的小写gz，再继续向前推断。程序把这四组结果逐一断言，避免只测试最常见的小写文件名。
这不是建议把所有文件名直接转小写。在区分大小写的文件系统中，名称变化可能对应不同文件。若业务规定接受某种大写压缩扩展，应单独定义可接受后缀的规范，并在实际内容验证之后使用，不能把名称归一化误当成内容核验。
未知类型是需要调用方决定的状态
unknown返回None与None，只表示本次映射表无法从名字确定类型。它不表示文件不存在，也不表示内容无效，更不能据此认为文件安全。程序使用application/octet-stream作为候选回退，是一种下载场景的选择；展示、预览或上传入口可以有不同策略。
如果系统只允许CSV，应把扩展名、解码成功、CSV结构与字段约束分开验收。文件改成csv后缀不一定就是CSV；反过来，一个未知后缀也可能包含合法CSV。后缀映射适合提供元数据起点，不能承担完整的格式识别任务。
严格开关控制映射范围
最后两行演示把自定义类型加入独立对象的非严格表。strict=True仍然查不到，strict=False才得到application/x-yunque-demo。这个strict不是“严查文件内容”，而是选择查询哪一类映射；名称听起来严格，也不会额外执行文件解析或安全检查。
示例使用不常见的教学后缀，避免与标准表碰撞。首次全局初始化仍可能读取系统映射，本例随后使用的独立对象不会继承这些额外条目。真实应用若需要固定输出，应把必要映射作为自身配置管理，并记录运行时版本。不同操作系统的系统映射与Python版本可能带来差别，所以跨机器排错时不要只对比同一段调用代码。
把文件名映射放在正确的流程位置
实际下载流程可以先确定要发送原压缩数据还是解压后的内容，再获取建议媒体类型，最后结合经过验证的内容设置响应头。上传流程则应先限制大小并检查允许格式，再决定如何存储或预览。两条流程都会用到名字，却不能因为拿到一个类型字符串就跳过其它条件。
本例只检查有限的内置后缀与一个自定义扩展，输出来自明确版本和隔离映射表。若要支持复合后缀、URL查询串或平台新增类型，应围绕真实输入补测试，并阅读对应版本文档。最重要的边界始终是：函数根据名称推断，调用者对实际发送和处理的字节负责。
参考资料
官方资料核验于2026年10月2日；上述输出来自本次固定输入实跑，退出码为0。
