nginx gzip_types需显式列出mime类型，覆盖默认仅压缩text/html的行为；必选text/html等基础类型，禁用通配符和已压缩二进制格式；须配合gzip on等指令，并确保mime.types映射正确、响应头content-type匹配。
直接在 http、server 或 location 块中写明要压缩的 MIME 类型即可。Nginx 不看文件后缀（比如 .js 或 .css），只认响应头里的 Content-Type——配置写对了但没生效，大概率是类型没匹配上，或者根本没启用压缩。
必须显式列出所有要压缩的类型
gzip_types 是覆盖式配置：一旦设置，就会完全替代 Nginx 默认仅压缩 text/html 的行为。漏掉 text/html，整个 HTML 页面就失去压缩，首屏加载明显变慢。
- 基础必选（建议直接复制）：
text/html text/plain text/css text/javascript application/javascript application/json application/xml text/xml application/xml+rss image/svg+xml - 现代前端可加：
text/markdown application/typescript application/font-woff2（注意 woff2 压缩需浏览器支持，且非所有场景都推荐） - 绝对不要写
text/*或application/*——Nginx 直接忽略，配置无效
避开已压缩的二进制格式
JPEG、PNG、GIF、MP4、AVIF、ZIP、PDF、WOFF2 等本身已是高压缩编码，再套 Gzip 几乎不省带宽，反而增加 CPU 开销和传输延迟，甚至可能让体积略微变大。
- 明确排除：
image/jpeg image/png image/gif video/mp4 application/zip application/pdf - SVG 是例外：
image/svg+xml是纯文本 XML，必须且应当压缩 - 警惕
application/octet-stream：这是“兜底类型”，常代表未识别资源（如 .md、.log），误加进去会连带压缩图片或 PDF
确保 MIME 类型与文件真实映射一致
你在 gzip_types 里写了 text/markdown，但如果 .md 文件返回的是 application/octet-stream（说明 Nginx 没识别出类型），那也不会压缩。
- 先检查
/etc/nginx/mime.types（Linux）或/usr/local/etc/nginx/mime.types（macOS） - 补充缺失映射，例如：
types { text/markdown md; application/typescript ts; } - 再在
gzip_types中加入对应项，名称必须完全一致（区分大小写）
配合必要指令并实测验证
gzip_types 单独存在是无效的，必须和以下指令共存才能起作用：
-
gzip on;——启用压缩功能 -
gzip_min_length 1024;——避免压缩过小响应（如空 JSON） -
gzip_comp_level 6;——平衡压缩率与 CPU 消耗（1–9，6 是常用值） -
gzip_vary on;——让缓存系统知道响应可能被压缩
改完配置后，用 curl 实测是否真生效：curl -I -H "Accept-Encoding: gzip" https://yoursite.com/main.js
确认响应头含 Content-Encoding: gzip 和 Vary: Accept-Encoding，同时核对 Content-Type: application/javascript 是否匹配你配置的类型。
