manifest文件在2026年5月已完全失效，Chrome 95+、Firefox 85+、Safari 16.4+均静默忽略html manifest属性；替代方案唯一且必须是Service Worker，需HTTPS或localhost环境注册，显式缓存与拦截fetch请求。
直接说结论：manifest 文件在当前（2026年5月）已**完全失效**，主流浏览器（Chrome 95+、Firefox 85+、Safari 16.4+）均已移除支持，任何基于 html manifest="xxx.appcache" 的写法都不会触发缓存，也不会报错——它只是被静默忽略。
为什么 manifest 属性不再起作用
这不是配置错误，而是标准层面的移除。W3C 已将 Application Cache 标记为废弃（obsolete），浏览器厂商陆续执行了删除。你可能看到旧文档里还能跑，那大概率是本地开发服务器没刷新、或用了过时的浏览器内核（比如某些 Electron 封装版）。真实用户环境里，它已经不存在了。
-
manifest属性在 HTML 解析阶段被浏览器直接跳过，不会发起对.appcache文件的请求 - 即使服务器正确返回了
text/cache-manifestMIME 类型，浏览器也无视内容 - 开发者工具的
Application面板中，“Manifest”选项卡已消失，只剩Service Workers
sw.js 是唯一可行的替代方案
要实现离线访问，必须用 Service Worker。它不是“另一种选择”，而是当前唯一标准化、全平台支持的机制。关键步骤不能跳过：
- 页面必须通过
https://或http://localhost提供（file://协议不支持注册） - 在主 JS 中调用
navigator.serviceWorker.register('sw.js')，且路径必须与页面同源 -
sw.js必须监听install事件并调用cache.addAll()预缓存资源列表 - 必须监听
fetch事件，用event.respondWith()显式返回缓存或网络响应 - 更新缓存时，需在
activate阶段调用caches.delete()清理旧 cache 名称
示例片段（sw.js）：
Article To Html
下载
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
立即学习“前端免费学习笔记（深入）”；
self.addEventListener('install', e => {
e.waitUntil(
caches.open('v1').then(cache => cache.addAll([
'/',
'/index.html',
'/style.css',
'/app.js'
]))
);
});
self.addEventListener('fetch', e => {
e.respondWith(
caches.match(e.request).then(r => r || fetch(e.request))
);
});
旧项目迁移时最容易踩的坑
很多团队想“先保留 manifest，再慢慢切到 SW”，这行不通。二者互斥，且 manifest 的残留会干扰调试判断：
- 删掉所有
<html manifest="...">，否则开发者工具里可能误判为“有缓存但没生效” - 服务器上停用
AddType text/cache-manifest .appcache这类配置，避免误导日志 - 不要指望
cache.addAll()自动包含 HTML 页面本身——必须显式列出/或具体路径，否则离线时空白 - 缓存名称（如
'v1'）每次变更都要同步改install和activate里的逻辑，否则旧缓存永远留着
真正难的不是写几行 SW 代码，而是理解：缓存策略必须由你完全定义，浏览器不再替你做“默认行为”。一个没写 fetch 拦截的 SW，和没注册一样。
