html不应长期缓存,应设no-cache或max-age=0,must-revalidate;静态资源需用哈希命名+public,max-age=31536000;meta标签无效,必须通过http响应头配置。

HTML 文件本身不该被长期缓存——它是一切渲染的起点,缓存错了,整个页面就错;但也不能完全禁用,否则每次都要重拉,首屏白屏时间直接多出 300–800ms。关键在于:按内容动态性选对 Cache-Control 指令,并确保静态资源(JS/CSS/图片)和 HTML 的缓存策略不打架。
HTML 响应头必须设 no-cache 或 max-age=0, must-revalidate
这是最容易翻车的一点:很多人看到“缓存能提速”,就给 index.html 加上 max-age=3600,结果用户改完文案、上线新包,浏览器还在用一小时前的 HTML,按钮点不动、文案没更新、甚至 JS 路径 404。
-
no-cache表示每次请求都需向服务器验证(发带If-None-Match的请求),服务器返回304 Not Modified就复用本地缓存——既避免全量下载,又保证内容最新 -
max-age=0, must-revalidate效果类似,但语义更明确:允许缓存,但强制验证 - 绝对不要用
public, max-age=31536000给 HTML——哪怕你用构建哈希(如index.a1b2c3.html),入口 HTML 本身仍是动态路由或 SSR 入口,不能靠文件名区分 - Nginx 示例:
location = /index.html { add_header Cache-Control "no-cache"; } - Express 示例:
res.set('Cache-Control', 'no-cache');
静态资源(JS/CSS/图片)必须用 max-age + 文件名哈希
HTML 是入口,但真正拖慢首屏的是它引用的 JS 和 CSS。如果这些资源没缓存,HTML 缓存再好也没用——每次都要重新下载几百 KB 的 bundle。
使用 PptxGenJS 和 Python 解析,将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint(.pptx)演示文稿。
- 给 JS/CSS 设置
Cache-Control: public, max-age=31536000(1 年),前提是文件名含内容哈希,例如main.ea7f2d.js - 构建工具(Webpack/Vite/Rollup)默认支持哈希输出,确认配置里启用了
contenthash或fullhash - 图片等二进制资源也适用同样策略;但如果是 CMS 后台上传的图片,无法自动加哈希,就得靠
ETag或Last-Modified协商缓存 - 千万别只改文件内容却不改文件名——浏览器认 URL,URL 不变,
max-age再长也只会加载旧版本
meta http-equiv="Cache-Control" 在现代浏览器中基本无效
你在 里写 <meta http-equiv="Cache-Control" content="no-cache">,DevTools 看着像生效了,但实际对 Chrome/Firefox/Edge 都不起作用。这不是 bug,是规范明确不支持。
- 这个
meta标签只在极个别 WebView 或旧版 Safari 中有降级行为,不能当作真实缓存控制手段 - 真正起效的只有 HTTP 响应头:由 Nginx/Apache、Node.js 后端、或托管平台(Vercel 的
vercel.json、GitHub Pages 的_headers)输出 - 纯静态托管(如 GitHub Pages)若没配
_headers,默认响应头是Cache-Control: no-cache或极短有效期,务必手动覆盖 - 验证方式:打开 DevTools → Network → 找到
index.html请求 → 查看 Response Headers 里的Cache-Control字段是否符合预期
CDN 缓存必须和服务端响应头对齐,否则会覆盖或冲突
CDN 不是缓存的“保险柜”,它是中间层——它可能无视你的服务端 Cache-Control,也可能按自己规则强行缓存 HTML 10 分钟,导致用户永远刷不到新页面。
- Cloudflare 默认开启“Auto Minify”和“Cache Everything”,必须关掉或加 Page Rule:对
/index.html设置Cache Level: Bypass或Edge Cache TTL: 60s - 阿里云 CDN 后台的“过滤参数”和“忽略 URL 参数”设置会影响缓存键,若 HTML 是
/?v=1.2.3这种带参路径,要确认是否被当成不同资源缓存 - 最稳妥做法:让 CDN 完全信任源站响应头,在 CDN 控制台开启 “Respect Origin Cache Headers”
- 调试时看响应头里的
x-cache(Cloudflare)或x-cdn-cache(阿里云),比只看Cache-Control更能定位问题
真正难的不是加一行 add_header,而是理清 HTML、JS/CSS、CDN、构建产物四者之间的缓存依赖链——其中任意一环断掉或错配,都会让优化变成负优化。尤其要注意:HTML 缓存策略永远服务于内容更新节奏,而不是单纯追求“缓存命中率”。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










