ThinkPHP静态资源版本号需通过配置static_version并拼入URL实现，推荐用filemtime()或Git哈希生成，配合Nginx/Apache对JS/CSS设置长期缓存头，同时排查浏览器、代理及CDN是否识别新版本号。
ThinkPHP怎么让CSS/JS文件自动加版本号
直接改 config/app.php 里的 app_debug 或靠手动改文件名，不是真解法。ThinkPHP 自带的静态资源管理机制（__STATIC__、__CSS__ 等）默认不带版本控制，必须自己接管 URL 生成逻辑。
核心做法是：用时间戳或 Git 提交哈希作为版本参数，拼在静态资源 URL 后面，比如 /static/js/app.js?v=20240520。但不能硬编码，得让模板函数自动注入。
- 推荐在
config/app.php中新增配置项：'static_version' => date('YmdHi', filemtime(ROOT_PATH . 'public/static/'))（仅开发环境可用；生产环境建议换成git rev-parse --short HEAD脚本输出） - 在公共模板里把
__STATIC__替换为带版本的路径：用{:config('app.static_version')}拼接，例如<link rel="stylesheet" href="__STATIC__/css/app.css?v=%7B:config('app.static_version')%7D"> - 别依赖浏览器自动缓存刷新——
app_debug=true时 ThinkPHP 会禁用部分缓存头，反而掩盖问题；上线前务必关掉app_debug并验证响应头中Cache-Control是否生效
为什么用 filemtime() 比 time() 更靠谱
time() 每次请求都变，等于废掉所有浏览器缓存；filemtime() 只在文件真实修改时更新，兼顾缓存效率和更新可靠性。
但要注意：ThinkPHP 的 public/static/ 目录下如果存在子目录嵌套（如 public/static/admin/js/），只取根目录 filemtime 就会漏判——某个 JS 文件改了，但整体目录时间没变，版本号就不动。
立即学习“PHP免费学习笔记（深入）”；
- 更稳的做法是计算关键文件的最新修改时间，例如：
max(filemtime('public/static/js/app.js'), filemtime('public/static/css/app.css')) - 如果用构建工具（Webpack/Vite），应该让构建脚本把哈希写入一个
version.json，PHP 读它而不是反复 stat 文件，避免 I/O 开销 - 注意 Windows 下
filemtime精度只有 1 秒，高频发布时可能撞时间——此时必须切到 Git 哈希方案
nginx/Apache 怎么配合不缓存 HTML 但缓存 JS/CSS
光 PHP 加 v=xxx 不够，服务器必须正确设置响应头，否则浏览器根本不会发带版本号的新请求。
典型错误是：HTML 页面返回了 Cache-Control: no-cache，但 JS 文件也跟着被设成不缓存，导致每次都要重下——其实你只想让 HTML 不缓存，JS/CSS 必须长期缓存。
- nginx 配置里要区分路径：
location ~* \.(js|css|png|jpg|gif|ico)$ { add_header Cache-Control "public, max-age=31536000"; } - 同时确保 HTML 相关 location（如
location /或location ~ \.php$）没有继承上面的缓存头，否则 JS 也会被误设 - Apache 用户注意：
.htaccess中的ExpiresByType对 PHP 输出的 HTML 无效，只对静态文件生效；动态页面的缓存头必须由 PHP 或 Web 服务器主配置控制
线上更新后用户仍加载旧 JS？先查这三处
不是“清缓存就能好”，而是有固定排查链路。90% 的情况卡在其中一环。
- 看浏览器开发者工具 Network 标签页，点开那个旧 JS 文件，确认 Request URL 里的
v=参数是否真的变了——没变说明 PHP 没重新生成版本号，或者模板没刷新 - 检查该 JS 文件响应头中的
ETag和Last-Modified：如果这两个还在，即使 URL 带新v=，某些代理或中间网关仍可能返回 304，导致内容没更新 - 确认 CDN 是否缓存了旧 URL（比如阿里云 CDN 默认缓存所有静态路径）：哪怕你改了 PHP 版本号，CDN 还拿着
/static/js/app.js?v=20240519的副本，新请求v=20240520它可能根本没刷到——得主动提交 URL 刷新或调高缓存键精度
版本号本身只是个标记，真正起作用的是整个链路上每个环节是否把它当回事。少一个地方认它，就白加。
