ThinkPHP静态资源压缩需构建时处理：一、build.php中sourcePath须为public/static等绝对路径；二、子目录部署需同步调整targetPath；三、用asset()配合version.json加哈希防缓存失效；四、Nginx需配置gzip_types包含text/css和application/javascript。
ThinkPHP 的静态资源压缩不是开个配置就能生效的，必须明确区分「构建时压缩」和「运行时压缩」——前者是真正减小文件体积、提升 CDN 传输效率的正解；后者（如 output_compress）只压缩 PHP 输出流，对 .js、.css 这类直接由 Web 服务器返回的文件完全无效。
build.php 配置失败：路径和入口位置决定成败
很多人执行 php think build 后发现资源没变小、甚至报 file not found，核心问题几乎都出在路径上：
-
sourcePath必须是相对于项目根目录的绝对路径写法，比如'public/static'，不能写成'./public/static'或'static' - 若项目部署在子目录（如
https://example.com/app/），targetPath和生成的 URL 映射需同步调整，否则压缩后文件写入错位 -
build.php中的ignore列表要排除构建干扰项，但别误删.js或.css文件本身（例如写成'*.js'会跳过所有 JS） - 入口文件
public/index.php的位置影响__ROOT__计算，间接导致build.php内部路径解析异常
asset() 函数加哈希版本号：防缓存失效的关键动作
光压缩不加版本控制，用户可能永远看不到新样式。ThinkPHP 的 asset() 是比硬写 {:__STATIC__}/js/app.js 更可控的方式，但默认不自动加哈希：
- 开发阶段可设
'app_debug' => true，asset()会附加?v=时间戳；生产环境必须配合build.php生成version.json，再在app/common.php中重写asset()行为，读取哈希拼接 - 模板中必须统一用
{:asset('js/app.js')}，不能混用{:__STATIC__}，否则版本逻辑断裂 - 注意大小写与斜杠方向：
version.json里是"js/app.js"，模板里就不能写成"JS/App.js"或"js\app.js"
Nginx 层 Gzip 开启但没生效？检查 gzip_types 和优先级
ThinkPHP 的 'output_compress' => true 对静态文件毫无作用，Gzip 是否生效完全取决于 Web 服务器：
立即学习“PHP免费学习笔记（深入）”；
- Nginx 必须在
server块中启用gzip on，且gzip_types显式包含text/css和application/javascript（仅写text/html不够） - 如果用了
location ~* .js$这类独立规则，需确认该 block 内也继承或重复声明了gzip on，否则会被覆盖 - 浏览器开发者工具 Network 标签页看响应头，有
Content-Encoding: gzip才算真正生效；若只有Vary: Accept-Encoding而无该头，说明压缩未触发
最容易被忽略的是：build 生成的压缩文件名若不含 .min. 或类似标识，CDN 可能因 MIME 类型识别失败而跳过压缩；建议在 build.php 的 targetPath 中保留原始扩展名，并靠 version.json 控制 URL 路径，而非靠文件名区分。
