HTML5 manifest 缓存机制已被现代浏览器废弃，更新失效主因是浏览器仅在 manifest 字节级内容变化时触发更新，空格注释无效；需改非注释行内容、禁用强缓存、手动调用 update() 和 swapCache() 并重载页面；应迁移到 Service Worker。
manifest 文件修改后浏览器没重新下载资源
HTML5 的 manifest 缓存机制早已被现代浏览器废弃（Chrome 94+、Firefox 85+、Safari 未实现且无计划支持），但若你仍在维护旧项目，遇到“改了 manifest 文件内容，页面刷新后资源却没更新”，根本原因不是缓存没清，而是浏览器只在 manifest 文件的**字节级内容发生变化**时才触发更新流程——空格、注释、换行变化都不算数。
实操建议：
- 确保
manifest文件响应头包含Content-Type: text/cache-manifest，否则浏览器直接忽略 - 每次修改必须变更 manifest 文件中至少一个非注释行的实际内容，例如更新版本号：
CACHE MANIFEST # v2.1.7 ← 这一行必须改动（且不能只是加空格）
- 检查服务器是否对
.manifest文件启用了强缓存（如Cache-Control: max-age=31536000），这会导致浏览器根本不重新请求 manifest 文件本身
用 JavaScript 手动触发更新检测失败
调用 window.applicationCache.update() 不生效，通常是因为应用缓存已处于 UPDATEREADY 状态但未执行 swapCache()，或事件监听未覆盖完整生命周期。
关键点：
立即学习“前端免费学习笔记（深入）”；
-
update()只有在缓存状态为IDLE时才发起检查；若当前是DOWNLOADING或UPDATING，它会被忽略 - 必须监听
updateready事件并显式调用applicationCache.swapCache()，否则新资源不会激活 - 刷新页面前，老缓存仍生效；
swapCache()后需手动重载：if (window.applicationCache.status === window.applicationCache.UPDATEREADY) { window.applicationCache.swapCache(); window.location.reload(); }
浏览器开发者工具里看不到 applicationCache 面板
Chrome 从 63 版本起移除了 DevTools 中的 Application → Cache → Application Cache 面板，Firefox 在 70+ 版本后也彻底弃用。这不是你的操作问题，而是标准淘汰的结果。
替代验证方式：
- 访问
chrome://appcache-internals/（仅限旧版 Chrome，新版已 404） - 在 Console 中执行
window.applicationCache查看对象是否存在及状态值 - 更可靠的方法：打开 Network 面板，勾选 “Disable cache”，然后刷新页面，观察资源是否从
from ServiceWorker或from disk cache加载——如果还显示from AppCache，说明你用的是极老内核
真正该做的事：迁移到 Service Worker
Manifest 缓存无法按需更新、不支持 HTTPS 强制要求、无运行时控制能力，这些问题 Service Worker 全部解决。别再花时间调试 manifest 的更新逻辑。
最小迁移路径：
- 用
navigator.serviceWorker.register('/sw.js')替代 - 在
sw.js中用cache.addAll([...])预缓存资源，用fetch事件拦截并返回缓存或网络响应 - 更新策略改为：修改
sw.js文件内容 → 浏览器自动下载新脚本 → 触发install和activate事件 → 调用clients.claim()立即接管页面
manifest 的缓存更新失效，本质是整个机制已死。你现在看到的“不生效”，其实是浏览器在礼貌地假装还在支持它。
