强制刷新失效主因是长效缓存头或Service Worker拦截；实操需禁用缓存、检查并注销Service Worker、同步更新所有资源URL参数、避免file://测试、移动端需原生配合清除缓存。
强制刷新没用，说明缓存没被绕过
Ctrl+F5 或 Command+Shift+R 失效，常见于两种情况：一是服务器返回了 Cache-Control: max-age=31536000 这类长效缓存头，浏览器根本不会发请求；二是页面通过 Service Worker 拦截了所有请求并返回了旧缓存。此时强制刷新只刷新了主 HTML，但 JS/CSS/图片等资源仍走缓存管道。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 打开开发者工具 →
Network标签页 → 勾选Disable cache，再刷新； - 检查响应头中是否有
Service-Worker-Allowed或页面里是否注册了navigator.serviceWorker.register； - 若确认有 Service Worker，需手动进入
Application → Service Workers，点击Unregister并勾选Update on reload。
修改 URL 参数后仍加载旧内容
加 ?v=2 无效，往往不是参数没加对，而是引用路径没同步更新——比如你改了 index.html?v=2，但页面里内联的 fetch('/api/data.json') 或 iframe 的 src 仍是旧地址，这些请求照样命中缓存。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 在
Network标签页过滤XHR和Fetch，逐个检查响应状态码和响应头中的cache-control； - 对动态请求（如 API、JSON）也加上唯一参数，例如
/api/data.json?t=1728735140（时间戳）或/api/data.json?_v=2； - 避免在 JS 中拼接带缓存参数的 URL 时漏掉引号或写错变量名，比如误写成
url + '?v=' + version却没定义version，结果发出去的是?v=undefined。
本地开发时 HTML 总是不更新
用 file:// 协议直接双击打开 HTML 文件时，Chrome/Firefox 会忽略大部分缓存控制头，且可能复用上次渲染的 DOM 快照，导致改完保存再刷新也没变化。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 绝对不要用
file://测试缓存行为，启动一个本地服务：VS Code 安装Live Server插件，或终端运行npx http-server； - 确保服务器返回的 HTML 响应头包含
Cache-Control: no-store，而不是仅靠 meta 标签（<meta http-equiv="Cache-Control" content="no-cache">在现代浏览器中基本无效）； - 检查编辑器是否启用了“保存时自动格式化”或“保存时编译”，导致你看到的是未生效的中间版本。
移动端 WebView 缓存顽固难清
Android WebView 和 iOS WKWebView 的缓存策略比桌面浏览器更隐蔽：它们会把 HTML、JS、CSS 甚至字体文件一并存进独立缓存区，且不响应 Disable cache 设置；用户手动清缓存也不一定清干净，尤其 App 没调用 clearCache() 或 clearWebsiteData() 时。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- App 开发者必须在每次发版时主动调用清除逻辑：Android 端用
WebStorage.getInstance().deleteAllData()+CookieManager.getInstance().removeAllCookies()；iOS 端调用WKWebsiteDataStore.default().removeData； - 前端可配合增加「强制刷新」按钮，点击后执行
window.location.reload(true)（注意：该参数在部分 WebView 中已被忽略，需配合原生层实现）； - 上线前务必在真机上测试冷启动（杀进程后首次打开）场景，因为热启动时 WebView 很可能复用旧缓存实例。
最易被忽略的一点：缓存问题从来不是单一环节的问题。它横跨协议层（HTTP 头）、运行时层（Service Worker）、构建层（资源哈希）、宿主层（WebView 实现）和用户层（浏览器设置）。排查时别只盯着 HTML 文件本身——先看 Network 面板里每个请求的实际响应头和状态码，再决定动哪一层。
