直接加v=会废掉缓存，因每次请求生成新时间戳导致浏览器无法复用js/css；应基于文件变更更新版本号，推荐用git哈希或构建工具输出version.json，并配合正确cache-control响应头与cdn配置。
为什么直接加 v=<?php echo time(); ?> 会废掉所有缓存
因为每次请求都生成新时间戳，浏览器根本不会复用任何 JS/CSS 文件，等于完全放弃缓存。真正要的是「文件变才更新版本号」，不是「每次访问都变」。filemtime() 是更合理的选择，但它有坑：只取 public/static/ 目录 mtime，而该目录的修改时间不会随子文件（比如 public/static/js/app.js）自动更新——Windows 下精度还只有 1 秒，高频发布时可能撞时间。
推荐做法是显式计算关键资源的最新修改时间：
max(filemtime('public/static/js/app.js'), filemtime('public/static/css/app.css'))- 或者用构建工具（如 Vite）输出一个
version.json，PHP 只读一次该文件，避免反复stat()开销 - 生产环境优先用 Git 哈希：
shell_exec('git rev-parse --short HEAD 2>/dev/null')，更稳定、无 I/O、不依赖文件系统精度
如何让模板自动注入版本号，而不是手动写 ?v=xxx
ThinkPHP 5.1 的 __STATIC__ 等常量默认不带版本参数，必须自己接管 URL 拼接逻辑。不能靠改 config/app.php 里的 view_replace_str ——那个配置在 5.1 中已失效，实际生效的是 template.php 里的 tpl_replace_str。
正确路径是：
- 在
application/config/template.php（若不存在则新建）中定义：return [ 'tpl_replace_str' => [ '__STATIC_VERSION__' => '/static?v=' . config('app.static_version'), ], ]; - 然后在模板里写：
<link rel="stylesheet" href="__STATIC_VERSION__/css/app.css"> - 注意：别用
{__STATIC__}这种写法，5.1 要求必须带花括号才触发替换；但更推荐统一用asset()函数，语义清晰且自动处理域名和子目录
服务器响应头没配对，加了版本号也白搭
浏览器是否发新请求，不取决于 URL 有没有 ?v=，而取决于上一次响应头里 Cache-Control 和 ETag 是否允许复用。常见错误是 Nginx/Apache 把 HTML 和 JS/CSS 一视同仁设成 no-cache，结果你拼命换版本号，浏览器还是拒绝加载新文件。
必须分开配置：
- HTML 页面（
.html或 PHP 渲染页）返回：Cache-Control: no-cache, must-revalidate - 静态资源（
.js、.css、.png等）返回：Cache-Control: public, max-age=31536000, immutable - Nginx 示例片段：
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff2?)$ { expires 1y; add_header Cache-Control "public, immutable, max-age=31536000"; }
上线前最容易忽略的三个验证点
很多问题不是代码写错，而是验证漏项：
- 关掉
app_debug = true——开启时框架会禁用部分缓存头，掩盖真实行为 - 用浏览器开发者工具 Network 面板，确认 JS/CSS 请求响应头里真有
Cache-Control: public, max-age=...，且状态码是304或200 (from disk cache)，不是每次都200 OK - 检查 CDN 或反向代理（如 Nginx 缓存层）是否把
?v=当作不同资源缓存——有些老旧 CDN 会忽略查询参数，导致新版本压根没推下去
版本号本身只是 URL 标识，真正起作用的是服务端响应头 + 浏览器缓存策略 + 中间层是否透传查询参数。三者缺一不可。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
