火狐浏览器“devtools failed to load source map”主因是源映射未启用、.map文件路径错误或加载失败、服务器未暴露.map资源、浏览器扩展干扰，或构建配置中sourcemapignorelist误过滤源文件；需依次检查调试器设置、network面板状态码、sourcemappingurl相对路径、扩展禁用及ignore规则。
火狐浏览器控制台提示“DevTools failed to load source map”或完全不显示 .ts/.js 源文件，说明原始代码与压缩产物之间的映射链断裂，调试时只能看到混淆后的 bundle.js，无法定位真实错误行、无法在 .vue 或 .ts 文件中打有效断点。
确认 Source Map 是否被浏览器启用
Firefox 默认开启 JavaScript Source Maps，但个别版本或用户手动关闭后不会自动恢复。打开开发者工具（Ctrl+Shift+I）→ 切换到“调试器”面板 → 点击右上角齿轮图标 → 在 Settings 中确认【Enable JavaScript source maps】已勾选。
若勾选后仍无效，检查是否同时启用了“Enable CSS source maps”（部分构建产物含 CSS Source Map，未启用会导致关联 JS 映射失败）。
排查 .map 文件加载失败原因
方法一：查看 Network 面板筛选 .map 请求
按 Ctrl+Shift+I 打开开发者工具 → 切换到 Network 面板 → 刷新页面 → 在过滤框输入 .map → 观察所有 .map 请求状态码。若出现 404，说明文件路径错误或未部署；若出现 403，说明服务器拒绝访问（如 Nginx 未配置 map 文件 MIME 类型）；若出现 net::ERR_FILE_NOT_FOUND，大概率是浏览器扩展干扰。
方法二：检查 sourceMappingURL 注释是否指向真实路径
在 Sources 面板中展开对应 JS 文件 → 查看文件末尾是否存在类似 //# sourceMappingURL=app.js.map 的注释 → 确认该路径是相对于当前 JS 文件所在 URL 的相对路径。例如 JS 地址为 https://example.com/static/js/app.js，则 .map 文件必须可从 https://example.com/static/js/app.js.map 访问到。
【关键提醒】：Vite 或 Webpack 构建时若 output.path 设置为 dist/assets，但 HTML 中 script src 是 /js/app.js，则 sourceMappingURL 会错配成 ../assets/app.js.map，实际应设为 ../../assets/app.js.map 或改用绝对路径 public/js/app.js.map。
排除浏览器扩展干扰
第一步：打开 about:debugging → 点击“此 Firefox” → 查看已启用的扩展列表
第二步：逐个禁用名称含 “polyfill”、“browser”、“devtools”、“inject” 的扩展（尤其是旧版 uBlock Origin、React Developer Tools 旧版、某些广告拦截插件）
第三步：禁用后刷新页面 → 检查控制台是否停止报错 → 若恢复，记录下问题扩展 ID（如 cfhdojbkjhnklbpkdaibdccddilifddb），永久移除或更新至兼容版本。
验证源文件是否被忽略
Firefox 调试器支持 Ignore List，但不像 Chrome 那样显式暴露入口。需手动检查：
打开调试器 → 左侧文件树顶部点击“Page” → 展开后若只显示 webpack:// 或 localhost:// 且无 src/ 目录结构，说明源文件被静默过滤。
此时需检查构建配置中是否设置了 devtool: 'hidden-source-map' 或 sourcemapIgnoreList，默认会屏蔽 node_modules 下所有文件——但若项目将 src 映射进 webpack://src/ 却又被 ignore，就会彻底消失。
解决方式：在 vite.config.ts 或 webpack.config.js 中显式清除 ignore 规则，例如 Vite 用户添加：sourcemapIgnoreList: () => false，强制加载全部源映射。
