nginx开启基础gzip压缩需在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，并通过nginx -v验证模块支持、curl或devtools确认content-encoding: gzip生效。
在 Nginx 中开启基础 Gzip 压缩，核心是让 HTML、CSS、JS、JSON、SVG 等文本类资源传输前自动压缩，通常可减少 60%–90% 的体积。它不改前端代码，也不依赖 CDN，但配置位置和关键参数必须准确，否则无效甚至引发响应异常。
确认 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，5 是速度与压缩率的合理平衡点）
- gzip_types text/html text/css application/javascript application/json application/xml+rss image/svg+xml application/x-httpd-php; —— 显式声明类型，务必包含 text/html 和 application/x-httpd-php（PHP 页面才可被压缩）
- gzip_vary on; —— 添加 Vary: Accept-Encoding 响应头，防止代理或 CDN 缓存错乱
- gzip_http_version 1.1; —— 明确使用 HTTP/1.1，兼容性更稳
验证是否生效
配置后先检查语法，再重载服务：
nginx -t && nginx -s reload
用 curl 测试：
curl -H "Accept-Encoding: gzip" -I https://your-domain.com/test.js
查看响应头中是否有 Content-Encoding: gzip。也可在浏览器 DevTools 的 Network 面板中检查 JS/CSS/HTML 文件的响应头。
避开常见错误
- 不要对 JPEG、PNG、MP4、PDF、WOFF2 等已压缩格式启用 gzip——几乎不减体积，纯耗 CPU
- 多站点场景下若在 server 块单独配置，需确保 gzip on 和完整 gzip_types 出现在顶层；如用 FastCGI，还需在 location ~ \.php$ 内重复写一次 gzip 指令，否则 PHP 输出不压缩
- 别遗漏 application/x-httpd-php —— 这是 PHP 动态页面能被压缩的关键 MIME 类型
