Local Overrides 是 Chrome DevTools 提供的本地文件替换线上脚本的调试功能，通过映射 URL 到本地路径实现运行时替换，支持断点、保留 sourcemap，需授权文件夹、禁用缓存并注意跨域与路径一致性。
在浏览器断点调试中，用本地文件替换线上脚本（即“Local Overrides”）是前端开发调试线上环境问题的高效方式。它不依赖服务端配合，也不需要修改构建流程，核心是让 DevTools 把你本地改写的 JS/CSS 文件“映射”到对应线上资源上，实现运行时替换。
启用 Local Overrides 并配置本地映射
打开 Chrome DevTools（F12），切换到 Application 面板 → 左侧选择 Overrides → 点击 “Select folder for overrides”，授权一个本地空文件夹（如 ~/devtools-overrides）。首次启用会提示开启“Allow access to file URLs”，需勾选并刷新页面。
之后访问任意线上页面，当在 Sources 面板中展开 Page 或 Network 下的某个 JS 文件（如 https://cdn.example.com/app.js）时，右键该文件 → 选择 “Save for overrides”。DevTools 会自动将该文件保存到你指定的本地文件夹中，并建立 URL 到本地路径的映射关系。
编辑本地文件并实时生效
保存后，该文件在 Sources 面板中会显示为可编辑状态（左侧出现小铅笔图标），且文件名旁带 “overridden” 标识。直接修改、保存（Ctrl+S / Cmd+S），刷新页面或触发对应逻辑，浏览器就会执行你本地的版本——无需重启服务、无需禁用缓存，改动立即可见。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- 支持断点：在本地覆盖的文件中打断点，调试时停靠的就是你改写的代码
- 保留 sourcemap：若线上资源带有效 sourcemap，仍可映射回原始源码（但覆盖后以本地内容为准）
- 注意路径一致性：覆盖仅基于完整 URL 匹配，
/static/js/main.a1b2.js和/static/js/main.c3d4.js被视为不同文件，需分别保存
常见问题与注意事项
覆盖功能对 HTTP/HTTPS 资源生效，但不适用于 data URL、blob URL 或 iframe 中的 sandbox 页面。另外：
-
跨域限制：若线上脚本来自其他域名（如 CDN），且未设置
Access-Control-Allow-Origin: *，DevTools 可能无法读取原始内容来保存覆盖——此时可先在 Network 面板中右键该请求 → “Open in Sources tab”，再手动复制内容到本地同名文件中，然后拖入 Overrides 文件夹完成映射 - 缓存干扰：确保已禁用缓存（Network 面板勾选 “Disable cache”），否则可能加载旧版本资源，导致覆盖不生效
- 多文件协作：每个被覆盖的文件独立映射，修改多个 JS 或 CSS，需逐个执行 “Save for overrides”
进阶技巧：配合 source map 调试压缩代码
如果线上 JS 是压缩版（如 app.min.js），而你有对应的未压缩源码和 sourcemap（app.min.js.map），可将 sourcemap 和源码一起放入 Overrides 文件夹，并确保 map 文件路径正确（例如 //# sourceMappingURL=app.min.js.map 指向本地位置）。DevTools 会自动解析并显示原始源码，此时你可在原始文件中打断点、修改逻辑，再通过覆盖机制注入到线上运行环境中。
