layui.config 的 version 参数必须设为 true 才能启用毫秒级时间戳，且必须在 layui.use 前调用；它仅作用于 js 模块，css/图片等需手动加版本参数，路径错误或时机不当会导致静默失效。
layui.config 的 version 参数必须设为 true 才能启用时间戳
直接在 layui.config 中把 version 设成 true，Layui 会自动给所有模块 JS 文件 URL 后追加 ?v=1732956720123 这样的毫秒级时间戳——这是唯一能让浏览器强制加载新 JS 的方式。设成字符串（如 'v2.8.0'）只是固定参数，用户不手动清缓存就拿不到更新。
常见错误是只改了 CSS 或 HTML 里的版本号，但没动 JS 加载逻辑；或者把 version: true 写在 layui.use 之后，压根没生效。
-
layui.config必须在layui.use之前调用，且只能执行一次 - 如果用了构建工具（如 webpack），
version: true会被忽略——此时应走构建时注入哈希值的方案 - CDN 场景下慎用
version: true，高频时间戳可能触发 CDN 缓存穿透，建议改用语义化版本字符串 + 缓存策略配合
extend 模块路径写错时 layui 不报错，但时间戳也加不上
当自定义模块（比如 myModule）的 extend 路径配置错误，Layui 会静默 fallback 到默认路径加载，而这个 fallback 行为绕过了 version 控制逻辑——结果就是那个模块的 JS 始终没带时间戳，缓存问题照旧。
典型现象：主模块更新了，但 laydate 或你自己的 utils.js 还在跑旧代码，控制台也无报错提示。
- 检查
layui.config({ extend: { 'myModule': '/static/js/myModule.js' } })中路径是否 404（用浏览器 Network 面板确认） - 确保路径是相对于
layui.js所在目录的相对路径，不是相对于 HTML 页面 - 若路径含
.js后缀，version仍会生效；但若漏写后缀，Layui 自动补.js时可能跳过 version 注入
仅靠 version 不能解决 CSS 和图片缓存
layui.config({ version: true }) 只影响通过 layui.use 加载的 JS 模块，对 layui.css、图标字体、背景图等静态资源完全无效。这些文件仍走 HTML 中 <link> 和 <img> 的原始 URL，浏览器照常缓存。
所以发布新版后，经常出现「JS 功能更新了，但 UI 样式还是旧的」这类错位问题。
- 给
<link rel="stylesheet">的href手动加?v=xxx，值可复用 JS 时间戳（如window.layui_version || Date.now()） - 图标字体（
layui/iconfont.ttf）和图片路径也要统一加参数，否则小图标可能显示方块 - 不要依赖
<meta http-equiv="Cache-Control">全局禁用缓存——它会让所有资源都失去缓存优势，拖慢首屏
动态时间戳要防重复生成导致缓存失效
如果在多个地方分别调用 Date.now() 生成时间戳（比如 JS 里一次、CSS 引用里一次、HTML 模板里一次），会导致同一页面内相同资源被当成不同 URL 加载多次，浪费带宽且可能引发样式错乱。
真正可靠的做法是全局只算一次，并透传到所有静态资源引用点。
- 在
layui.config前定义const CACHE_VERSION = Date.now();，然后version: CACHE_VERSION - 后端模板中（如 JSP/Thymeleaf）也用同一变量拼接 CSS/JS 路径，保证全链路一致
- 若用 Nginx，可通过
add_header Cache-Control "no-cache" always;临时覆盖，但仅限灰度环境，上线后必须切回 version 参数方案
version 是个精细活：它不报错、不警告、不兜底，一旦路径或时机出错，时间戳就悄无声息地消失了。最危险的是你以为它在工作，其实只有部分模块受控。
