应建立运行时可感知、可响应、对用户友好的版本检测机制：构建时生成唯一可信版本标识（推荐内容哈希或构建指纹+时间戳），写入不缓存的/version.json；运行时主动拉取比对，语义化判断是否更新；检测到新版本后智能提示，支持用户可控刷新，并通过SharedWorker、Service Worker等增强多标签、离线等场景鲁棒性。
要解决浏览器缓存导致用户长期停留在旧版页面的问题，关键不是“禁止缓存”，而是建立一套运行时可感知、可响应、对用户友好的版本检测机制。核心逻辑是：让前端在运行中主动识别“当前加载的代码”和“服务器最新发布的代码”是否一致；不一致时，以低侵入方式提醒用户刷新。
构建阶段生成唯一且可信的版本标识
版本号必须在构建时确定，不能靠运行时读取 package.json 或时间戳（易被篡改或不一致）。推荐两种生产级方案：
-
内容哈希（推荐）：Webpack/Vite 打包时为 JS/CSS 文件生成
[name].[contenthash].js，再将该哈希值提取为应用整体版本，例如取主入口 chunk 的 hash 或聚合所有关键 chunk 的 hash 值。这种方式真正反映代码变更，语义精准。 -
构建指纹 + 时间戳组合：如
v1.2.3-202607211548，其中v1.2.3来自 package.json，后缀为构建时间毫秒。需确保构建流程中自动注入（如通过DefinePlugin或环境变量），避免人工维护出错。
生成后，把版本写入一个静态可访问的文件（如 /version.json），并确保它不被 CDN 缓存（设置 Cache-Control: no-cache, must-revalidate）。
运行时主动拉取并比对服务端版本
页面加载完成后，发起一次轻量 HTTP 请求获取 /version.json，与当前运行版本对比。注意几个关键点：
PigX UI 前端开发
下载
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
立即学习“前端免费学习笔记（深入）”；
- 请求需带防缓存参数（如
?t=+new Date().getTime()），或设置cache: 'no-store'，防止 fetch 被浏览器缓存拦截。 - 比对逻辑建议使用语义化版本比较（如
semver.gt(latest, current)），而非简单字符串相等——允许灰度发布或跳版本场景下更灵活控制。 - 首次访问无本地记录时，应自动存储当前版本到
localStorage，作为后续比对基准。
智能提示与用户可控的刷新策略
检测到新版本后，不直接强制刷新，而是提供清晰、可操作的反馈：
- 弹窗提示（如
ElMessageBox或Antd Modal）说明“检测到新版本，刷新后可获得最新功能与修复”，按钮文案明确（“立即刷新” / “稍后提醒”）。 - 同步显示一条顶部通知（
ElNotification），不打断操作流，适合轻量更新。 - 若用户点击“稍后”，可设置 2 小时内不再提示；若用户关闭弹窗，下次进入页面前 5 分钟再次检测并提示。
- 对紧急更新（如安全补丁），可在
version.json中增加force: true字段，此时跳过“稍后”选项，仅保留“立即刷新”。
增强鲁棒性：应对多标签、离线与资源失效场景
真实用户可能开着多个标签页，或网络临时中断。机制需兼顾这些边界：
- 使用
SharedWorker统一管理版本检查逻辑，所有同源页面共享同一轮询任务，避免重复请求、状态冲突，节省资源。 - 结合
Service Worker缓存/version.json并监听fetch事件，在网络异常时 fallback 到上次成功获取的版本做比对（需记录时间戳，避免用过期太久的缓存）。 - 监听
beforeunload或visibilitychange，在用户切回页面时触发一次即时检测，弥补轮询间隔空窗。 - 在控制台输出当前版本与服务端版本，方便 QA 和用户自助排查（如
console.log('[Version] current:', __APP_VERSION__, 'server:', res.version)）。
