manifest文件必须以严格大小写的“cache manifest”开头，末尾无空格或bom；路径相对manifest位置解析，推荐用绝对路径；仅network和fallback支持前缀通配；更新需字节级变更；现代浏览器已废弃，应迁移到service worker。
manifest 文件必须以 CACHE MANIFEST 开头
浏览器只认这一行作为合法 manifest 的起始标识，大小写敏感，末尾不能有多余空格或 BOM。如果写成 cache manifest、CACHEMANIFEST 或带 UTF-8 BOM，整个文件会被忽略，且不会报错——资源照常加载，但完全不走离线缓存。
常见误操作：
- 用编辑器保存为 UTF-8 with BOM（尤其是 Windows 记事本）→ 用
file -i your.appcache检查编码，改用无 BOM 的 UTF-8 - 在第一行前加注释（如
# version 1.2）→ 注释只能放在CACHE MANIFEST行之后 - 漏掉换行 →
CACHE MANIFESTNETWORK *这种连写会导致解析失败
CACHE 区块里路径是相对 manifest 文件位置解析的
不是相对于 HTML 页面，也不是相对于域名根目录。比如 index.html 引用了 app.manifest，而 app.manifest 存在 /static/ 下，那么它内部写的 js/main.js 就会被解析为 /static/js/main.js，而非网站根目录下的 /js/main.js。
稳妥做法：
立即学习“前端免费学习笔记（深入）”；
- 统一把 manifest 放在站点根目录（如
/app.manifest），这样路径可直接按站内 URL 写 - 路径尽量用绝对路径（以
/开头），避免歧义：/css/style.css、/api/config.json - 不要写协议+域名（
https://example.com/logo.png），跨域资源无法被缓存 - 支持通配符仅限于
NETWORK和FALLBACK，CACHE区块不支持*或**
NETWORK 和 FALLBACK 的匹配逻辑容易被误解
NETWORK 是「从不缓存」白名单，但它的通配规则是前缀匹配，不是 glob 或正则。例如写 api/，会匹配 /api/login、/api/v2/data，但不匹配 /public/api/status；写 * 表示所有未显式声明的资源都绕过缓存（即默认网络优先）。
FALLBACK 格式为 online-path fallback-path，注意两点：
- online-path 也按前缀匹配，且必须以
/开头（如/pages/ /offline.html） - fallback-path 必须是已缓存在
CACHE区块里的资源，否则降级失败，页面直接报 404 - 不支持 query 参数匹配：
/data.json?ver=2和/data.json被视为不同资源，后者需单独列在 CACHE 中才能 fallback
HTML 中引用和更新 manifest 的实际影响
通过 启用后，浏览器会在首次加载时下载并解析 manifest，并缓存所有 CACHE 列表资源。但关键点是：**只有 manifest 文件内容发生字节级变化，浏览器才会重新下载整个缓存组**。
所以日常维护要注意：
- 别靠改注释触发更新（如
# v1.0.1）→ 注释不参与比对，必须改非注释行（哪怕加个空格） - 动态资源（如
/time.php）即使进了 CACHE，每次访问仍可能返回新内容（取决于服务器 Cache-Control），manifest 不保证内容静态性 - 删除某个资源后，旧版本浏览器仍会从缓存返回它，直到用户强制刷新或 manifest 更新且该资源被移出 CACHE
- 现代浏览器（Chrome 95+、Firefox 92+、Safari 16.4+）已废弃 Application Cache，仅部分旧项目或 WebView 场景还需兼容
真正需要离线能力的新项目，请直接用 Service Worker，manifest 机制已不具备演进空间。
