HTML5离线缓存的现行标准是Service Worker+Cache API,AppCache已被主流浏览器废弃;若需兼容旧环境,manifest文件首行须为全大写无空格的CACHE MANIFEST,且需严格遵循三段式结构、正确HTML引用及服务器MIME配置。

HTML5 离线缓存的标准结构,核心是 manifest 文件的语法规范与 HTML 的正确引用,但必须明确一点:AppCache(即 .appcache / manifest)已被所有主流浏览器废弃(Chrome 94+、Firefox 84+、Safari 16.4+ 均已移除支持)。它不再是“标准”,仅适用于极少数遗留系统(如老旧定制 WebView)。真正符合当前 HTML5 标准的离线方案是 Service Worker + Cache API。
不过,若你确需在兼容旧环境时编写 manifest 文件,其标准结构必须严格满足以下条件:
manifest 文件必须以 CACHE MANIFEST 开头
首行必须是 CACHE MANIFEST(全大写、无空格、无 BOM、无注释),且不能有任何前置字符。例如:
✅ 正确:
CACHE MANIFEST
# v2.1.0
❌ 错误:
cache manifest(大小写错)
CACHE MANIFEST(开头空格)
// CACHE MANIFEST(注释行在第一行)
立即学习“前端免费学习笔记(深入)”;
htmlq 是一个命令行工具,使用 CSS 选择器从 HTML 中提取内容,相当于 jq 的 HTML 版本。该工具使用 Rust 编写,允许你通过 CSS 选择器将 HTML 管道化,直接从终端提取文本、属性和结构化内容。
三段式结构要完整、位置正确
manifest 文件可包含三个区块:CACHE:、NETWORK:、FALLBACK:,顺序不限,但每段必须以冒号结尾,后跟换行和资源路径(相对路径优先)。
- CACHE: 列出必须离线可用的静态资源(HTML/CSS/JS/图片等),路径需与 manifest 同源;
-
NETWORK: 列出绝不缓存、强制联网访问的资源,如
/api/*或通配符*; -
FALLBACK: 每行两个路径,用空格分隔,格式为
online-path fallback-path,例如/ /offline.html表示根路径离线时显示 offline.html。
示例片段:
CACHE MANIFEST
# v1.0.3
CACHE:
/index.html
/style.css
/app.js
/images/icon.png
NETWORK:
/api/
FALLBACK:
/ /offline.html
HTML 中引用方式与服务器配置缺一不可
必须同时满足三项,否则 manifest 不生效:
- 在
标签中添加manifest="cache.appcache"属性(路径须正确,建议同目录); - 服务器必须返回
text/cache-manifestMIME 类型(Apache 加AddType text/cache-manifest .appcache,Nginx 在types{}中声明); - manifest 文件本身不能被其他缓存机制(如 HTTP Cache-Control)拦截或压缩,需确保浏览器能原始读取内容。
真正推荐的标准做法:用 Service Worker 替代 manifest
现代 HTML5 离线能力的标准实现是 Service Worker,它不是“配置文件”,而是可编程脚本:
- 注册必须在 HTTPS 或
localhost下进行; - 主页面加载完成前调用
navigator.serviceWorker.register('/sw.js'); -
sw.js中使用caches.open()和cache.addAll()预缓存关键资源; - 监听
fetch事件,自主决定返回缓存、网络或 fallback 响应; - 更新逻辑由开发者控制——修改
sw.js内容即触发新版本安装。
这比 manifest 更可靠、更可控、更安全,且是 PWA(渐进式 Web 应用)的基础。


















