应采用哈希文件名(如main.7a2b3c.css)配合immutable强缓存,并确保HTML禁用缓存;未哈希时需依赖ETag协商缓存,且必须验证响应头实际生效。

直接改 CSS 文件内容不会让浏览器加载新样式——它只认 URL 和缓存头。要避免用户卡在旧版 CSS,关键不是“清缓存”,而是让浏览器主动放弃旧文件、拉取新文件。
用哈希文件名 + immutable 强缓存
构建时生成带 contenthash 的 CSS 文件(如 main.7a2b3c.css),再配 Nginx 强缓存:
location ~* "\.[a-f0-9]{8,}\.(css|js)$" {
add_header Cache-Control "public, max-age=31536000, immutable" always;
expires 1y;
access_log off;
}
这样浏览器会把该文件当作“永久不变”来缓存,只要 URL 变了(hash 改了),就必然走新请求。不加 immutable 时,某些浏览器(如 Safari)可能在重定向或页面跳转后仍复用旧缓存副本。
- 必须用正则匹配哈希格式,不能只靠后缀;否则
style.css也会被误套一年缓存 -
always是必须的——Nginx 默认不覆盖上游(如 Node.js 后端)已设的Cache-Control - 构建工具(Webpack/Vite)需启用
contenthash,且 HTML 中引用的路径要自动更新
HTML 必须禁用强缓存
如果 index.html 被缓存,哪怕 CSS 文件名变了,浏览器仍用旧 HTML 里的旧链接去加载,新样式根本不会触发下载。
location ~* \.html$ {
add_header Cache-Control "no-cache, must-revalidate" always;
}
location = / {
try_files /index.html =404;
add_header Cache-Control "no-cache" always;
}
no-cache 比 max-age=0 更可靠:前者强制每次验证(发 If-None-Match),后者在某些代理下仍可能走本地副本。
Lightning CSS 是由 Parcel 团队开发的基于 Rust 的 CSS 解析器、转换器、打包工具和压缩工具。此技能适用于需要优化样式表、为目标浏览器降低现代 CSS 语法以及将快速 CSS 处理集成到构建或重构工作流中的代理。
- 别漏掉根路径
/,单页应用常靠它 fallback - 上线后立刻检查 Network 面板里 HTML 响应头,确认是
no-cache,不是空或被 upstream 覆盖 - 开发环境若开了 Chrome 的 “Disable cache”,这些配置不生效,测试前务必关掉
没哈希的 CSS 怎么办?只能靠协商缓存兜底
如果暂时无法改造构建流程(比如老项目还用 style.css),就得依赖 ETag + no-cache 组合:
location ~* \.css$ {
add_header Cache-Control "no-cache" always;
# 确保后端生成 ETag 或 Last-Modified
}
浏览器每次请求都会带上 If-None-Match,服务端比对后返回 304(不传内容)或 200(传新内容)。但这有风险:
- 若服务端没开 ETag(如 Nginx 默认关闭),
no-cache就退化成“每次都重下整个 CSS” - CDN 可能忽略
no-cache并自作主张缓存,需单独配置 CDN 缓存规则 - 用户首次访问和缓存过期后的回源成本,远高于哈希方案的一次性下载
最易被忽略的点:缓存策略是否真正生效,不取决于你写了什么,而取决于最终响应头里实际输出的是什么。上线后第一件事,不是看代码,是打开 DevTools → Network → 刷一次首页 → 点开 HTML 和任意一个 CSS 文件,逐个检查响应头里的 Cache-Control 值是否符合预期。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










