ThinkPHP 8 静态资源必须放 public/static/，模板用 {:url('static/css/app.css', '', false)} 引用，Nginx 需配置 location ^~ /static/ + alias 指向该目录，并启用哈希或时间戳防缓存。
ThinkPHP 8 项目更新 CSS 或 JS 后用户仍加载旧文件、模板中写死 /static/css/app.css 导致子目录部署全挂、Nginx 返回 404 却查不到原因——这些问题根源不在代码，而在静态资源路径从存放位置、Web 服务器映射、模板生成逻辑到缓存控制这整条链路上没对齐。
静态资源必须放哪？放错直接 404
所有 CSS、JS、图片等静态文件，【必须】放进 public/static/ 目录下，例如 public/static/css/app.css。不能放在 app/、config/ 或 runtime/ 里——这些目录 Web 服务器根本无法直读，浏览器发起请求时直接返回 404。ThinkPHP 不代理静态文件，Apache/Nginx 是靠把 public/ 设为网站根目录来实现访问的。
别自作主张建 public/assets/ 或 public/res/，除非你同步改了 Nginx 的 location 规则，并手动更新所有模板里的 <link> 和 <script></script> 标签路径。
多模块项目也统一走 public/static/，不要按模块拆成 public/admin-static/——CDN 缓存、构建工具、版本哈希都会因此失效。
立即学习“PHP免费学习笔记（深入）”；
模板里怎么引用才不翻车
硬写 <link href="/static/css/app.css"> 看似能跑，但一加子目录（比如部署到 https://example.com/myapp/）就炸。正确做法是用 ThinkPHP 内置的 url() 辅助函数生成路径：
{:url('static/css/app.css')}
更稳妥的写法是传第三个参数 false，避免 URL 前缀重复拼接：{:url('/static/css/app.css', '', false)}。这个 false 很关键，否则在开启 url_html_suffix 时，url() 可能自动补上 .html 后缀，导致静态资源路径错误。
PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
在 JS 文件里动态加载 CSS？别手拼 /static/，用框架注入的常量 __ROOT__/static/——它由模板编译时自动替换，比硬编码可靠得多。
Nginx 必须这样配，否则静态请求被 PHP 劫持
第一步：确认 location ^~ /static/ 块写在所有 ~ \.php$ 规则之前。顺序颠倒会导致静态请求先被 PHP 规则捕获，返回 404 或空白响应——此时你加任何版本号都无效。
第二步：用 alias（不是 root）精确指向物理路径：alias /var/www/myapp/public/static/;。用 root 会多拼一层 /static/，造成路径错位。
第三步：执行 curl -I https://yoursite.com/static/css/app.css，检查响应头中是否有 Content-Type: text/css 和有效的 Cache-Control。若返回 text/html 或无缓存头，说明请求被路由系统劫持，必须修正 Nginx 配置，【alias 必须指向 public/static 目录，且不能用 root 替代】。
启用版本哈希，让浏览器强制刷新缓存
方法一：使用 Mix.version() —— 在构建脚本（如 Vite 或 Webpack）中启用文件名哈希，输出 app.a1b2c3d4.css，再通过 url() 生成带哈希的路径。框架能自动识别并解析，无需改 Nginx 配置。
方法二：用 filemtime() 时间戳追加查询参数：{:url('static/css/app.css')}?v={:filemtime(public_path('static/css/app.css'))}。简单有效，但每次修改文件都会触发全量缓存失效，适合小项目。
方法三：Nginx immutable 强缓存 + 哈希文件名组合。在 location ^~ /static/ 块中加：expires 1y; add_header Cache-Control "public, immutable";。此配置要求文件名本身含哈希（如 app.a1b2c3d4.css），浏览器一旦缓存即永不重验，彻底规避旧资源残留问题。
