manifest 属性已废弃，现代项目应使用 Service Worker；它必须写在 <html> 标签上，且需严格遵循 MIME 类型、文件格式与路径规则，否则缓存失效。
manifest 属性已废弃，现代项目不应再使用。 它在 Chrome 95+、Firefox 85+、Safari 16.4+ 中被完全移除，即使配置正确也不会触发缓存行为。如果你正在维护老系统或调试遗留代码，才需要了解它怎么“曾经”工作；新项目请直接用 Service Worker。
manifest 属性必须写在 <html> 标签上
不是 <head>，不是 <body>，只能是根元素 <html> 开始标签的属性。浏览器只认这个位置：
<!DOCTYPE html> <html manifest="cache.appcache"> <head></head> <body></body> </html>
- 路径必须可访问：比如
manifest="cache.appcache"要求该文件与 HTML 同目录；manifest="/static/cache.appcache"则需确保路径真实存在且返回 200 - 值不能是空字符串或
""，否则会被忽略 - 如果页面通过 iframe 加载，父页的
manifest不会作用于子页，每个 HTML 文件都得单独声明
cache.appcache 文件内容必须严格符合格式
首行必须是 CACHE MANIFEST（大小写敏感，不能多空格、不能写成 CACHEMANIFEST），后续段落用冒号分隔，每段后换行，资源路径按行列出：
CACHE MANIFEST # v20260622 <p>CACHE: /index.html /style.css /app.js</p><p>NETWORK: /api/ /login</p><p>FALLBACK: / /offline.html
-
CACHE:是唯一必需段；NETWORK:和FALLBACK:可省略，但一旦出现，冒号不能丢 - 注释行以
#开头，常用来放版本标识；只要任意字符变化（哪怕改个空格），浏览器就认为 manifest 更新，触发全量重缓存 - 路径支持相对路径（如
js/main.js）和绝对路径（如/img/logo.png），但不支持协议绝对 URL（https://cdn.example.com/xxx.js会被忽略） -
NETWORK: *表示所有未显式缓存的请求都必须联网，这是常见写法，但要注意它会覆盖FALLBACK规则
服务器必须返回 text/cache-manifest MIME 类型
哪怕文件内容完全正确，只要响应头里没有 Content-Type: text/cache-manifest，浏览器就当它不存在。Apache 和 Nginx 配置差异很大：
立即学习“前端免费学习笔记（深入）”；
- Apache：
AddType text/cache-manifest .appcache必须加在站点配置或.htaccess中；仅靠文件扩展名不够 - Nginx：
types { text/cache-manifest appcache; }或更稳妥地在 location 块中加add_header Content-Type text/cache-manifest; - 本地开发用 Python
http.server？它默认不支持自定义 MIME，会返回text/plain，缓存必然失败 —— 必须换用serve、live-server或轻量 Node 服务
缓存更新机制极易误判，调试困难
manifest 的更新不是“改了 JS 就更新”，而是“只有 manifest 文件内容变化才会触发”。这意味着：
- 修改了
app.js但没改cache.appcache？浏览器继续用旧缓存，用户看不到改动 - 改了
cache.appcache里一行路径，整个缓存组（包括 HTML/CSS/JS）全部重新下载，无法增量更新 - 浏览器不会告诉你“缓存失败”，只会静默降级为普通加载；要确认是否生效，得打开 DevTools → Application → Cache Storage（旧版叫 Application Cache），看是否有条目，且状态为
idle或checking - 首次访问页面时，HTML 本身会被缓存；但若该 HTML 没写
manifest属性，它就不会进缓存组 —— 所以离线时访问未声明 manifest 的页面，依然 404
真正麻烦的是：缓存行为高度依赖浏览器实现细节，不同版本表现不一致，而这些细节现在连 MDN 都不再维护文档。能不动就别碰它。
