nginx启用gzip压缩需先确认已编译支持--with-http_gzip_module模块，再在http块中配置gzip on、gzip_min_length 1024、gzip_comp_level 5、显式gzip_types（含text/html和application/x-httpd-php）、gzip_vary on及gzip_http_version 1.1，最后用curl -h "accept-encoding: gzip" -i验证content-encoding: gzip响应头。
在 Nginx 中启用 Gzip 压缩，核心是让 HTML、CSS、JS、SVG、JSON 等文本类资源在传输前被压缩，通常可减少 60%–90% 的体积。它不改代码、不依赖 CDN，但配置错一步就可能无效甚至引发 404 或 Content-Encoding 错误。
确认 Nginx 已支持 gzip 模块
模块不存在，所有配置都白搭。执行以下命令验证：
nginx -V 2>&1 | grep -o with-http_gzip_module
有输出说明已编译支持；若无结果，当前 Nginx 是精简版或旧版本，需重新编译并添加 --with-http_gzip_module 参数。注意：gzip_static 是另一个独立模块，不能替代基础 gzip 功能。
在 http 块中添加关键配置
必须放在 http { } 块内（不是 server 或 location 内），否则不生效。推荐配置如下：
- gzip on; —— 启用压缩
- gzip_min_length 1024; —— 小于 1KB 的文件不压（避免压缩开销大于收益）
- gzip_comp_level 5; —— 压缩级别设为 5（1–9，兼顾速度与压缩率）
-
gzip_types —— 显式列出要压缩的 MIME 类型，例如：
text/plain text/css application/javascript application/json text/xml application/xml+rss image/svg+xml application/x-httpd-php
（务必包含 text/html 和 application/x-httpd-php，否则 PHP 页面不会被压缩） -
gzip_vary on; —— 添加
Vary: Accept-Encoding响应头，避免缓存混淆 - gzip_http_version 1.1; —— 兼容性更稳（HTTP/1.0 不默认支持压缩）
避免常见踩坑点
- 不要对 JPEG、PNG、GIF、MP4、PDF、WOFF2 等本身已压缩格式启用 gzip——几乎不减体积，反而浪费 CPU
- 若在 server 块中单独启用（多站点场景），需确保 gzip on 和 gzip_types 出现在 server 块顶层，且包含 application/x-httpd-php；如果用了 fastcgi，还要在
location ~ \.php$块里再写一遍 gzip 指令，否则 PHP 响应不压缩 - 修改后务必执行 nginx -t 检查语法，再用 nginx -s reload 生效
验证是否真正生效
用 curl 测试响应头：
curl -H "Accept-Encoding: gzip" -I https://your-site.com/style.css
查看返回中是否有：
Content-Encoding: gzip
也可打开浏览器开发者工具 → Network 标签页 → 刷新页面 → 点击任意 JS/CSS 文件 → 查看 Response Headers。出现 content-encoding: gzip 即表示成功。
