Safari本地调试JS需启用开发者工具、启动HTTP服务器、严格匹配路径映射并刷新验证：必须用localhost、文件名含完整URL（含参数）、刷新页面生效，网络面板显示“local override”即成功。
当你在 Safari 浏览器中打开线上网页，发现某个 JS 行为异常但无法直接修改生产环境代码时，需要在本地调试修复逻辑并实时验证效果，这时必须绕过 CDN 缓存、跳过 HTTPS 限制、精准替换原始脚本路径，否则改了等于没改。
启用 Safari 开发者工具与本地服务器支持
打开 Safari → 偏好设置 → 高级 → 勾选「在菜单栏中显示“开发”菜单」。
启动本地静态服务器（如 Python 内置服务）：终端执行 python3 -m http.server 8000，确保你的本地 JS 文件可通过 http://localhost:8000/fix.js 访问。注意 Safari 默认阻止非 HTTPS 网站加载本地 HTTP 脚本，【必须用 localhost 或 127.0.0.1，不能用 127.0.1.1 或自定义 host 别名】。
定位并拦截目标线上 JS 资源
在目标网页按 Cmd+Opt+I 打开开发者工具 → 切换到「网络」标签页 → 刷新页面 → 在过滤栏输入 .js → 找到你要替换的 JS 文件（例如 https://cdn.example.com/v2/main.bundle.js）。
右键该请求 → 选择「复制 → 复制资源链接」→ 粘贴到新标签页确认可访问且非 404；若返回 403 或 CORS 错误，说明该脚本被防盗链或需带 Cookie，此时本地替换将失败，需另寻入口点。
配置本地资源映射（Override）
点击开发者工具左上角「文件」图标 → 选择「添加文件夹以进行资源覆盖」→ 选择你存放本地 JS 的目录（如 ~/Desktop/safari-overrides）→ Safari 会自动创建一个空的 override 项目并启用开关。
在「资源」面板左侧，展开 override 文件夹 → 右键 → 「新建文件」→ 文件名必须与线上脚本路径**完全一致**（包括查询参数），例如线上是 https://cdn.example.com/v2/main.bundle.js?ts=1715823900，你就得新建 cdn.example.com/v2/main.bundle.js?ts=1715823900，路径层级用斜杠分隔，不能用反斜杠。
双击该新建文件 → 粘贴你本地调试好的 JS 内容 → 保存（Cmd+S）。Safari 会立即尝试加载这个本地副本，但仅当当前页面后续重新请求该 URL 时才生效——首次加载已完成的脚本不会热替换，【必须刷新页面或触发脚本重载（如动态 import()、document.write 插入）才能看到效果】。
验证替换是否生效
方法一：回到「网络」面板 → 刷新页面 → 找到对应 JS 请求 → 查看「大小」列，若显示 local override 字样，且响应预览中内容为你本地写的代码，即成功。
方法二：在「控制台」中执行 document.querySelector('script[src*="main.bundle.js"]').src，输出应仍为线上地址（这是正常现象）；但执行 console.log(YourDebugFunction) 若返回你本地改过的函数体，说明执行流已走本地逻辑。
方法三：在「来源」面板 → 左侧资源树中找到 override 下的同名文件 → 设置断点 → 刷新后命中，即可单步调试。
