能调试压缩后的 JavaScript 代码，本质是通过 SourceMap 将运行时位置映射回原始源码；需构建工具正确生成并输出 SourceMap，JS 文件末尾含正确的 sourceMappingURL 注释，浏览器加载后即可在原始文件中设断点、查看变量。
在压缩后的 JavaScript 代码中调试，本质是靠 SourceMap 将运行时的压缩代码位置映射回原始未压缩源码。只要 SourceMap 正确生成并被浏览器识别，你就能像调试源码一样加断点、查看变量、单步执行。
确保构建工具正确生成 SourceMap
SourceMap 不是浏览器自动生成的，必须由构建工具（如 Webpack、Vite、Rollup、Terser）在打包时显式开启并输出。常见配置要点：
- Webpack：在 devtool 配置项中设为 "source-map"（完整独立文件）、"eval-source-map"（开发快）或 "hidden-source-map"（生产环境不暴露但保留，供错误监控用）
- Vite：默认开发环境自动启用，生产构建需在 build.sourcemap 中设为 true
- Terser（压缩器）：若单独使用，需传入 --source-map 参数，并确保 sourceMap: { filename: 'xxx.js.map' } 与输出 JS 同目录且路径可访问
- 关键：压缩后的 JS 文件末尾必须包含注释行，例如 //# sourceMappingURL=app.min.js.map，浏览器靠它加载对应 .map 文件
确认浏览器已加载并解析 SourceMap
打开 Chrome DevTools → Sources 面板，左侧文件树中展开 top → webpack:// 或 localhost → your-project，应能看到原始源码文件（如 src/index.ts），而非只有 app.min.js。若只看到压缩文件：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 检查 Network 面板：过滤 .map，确认 app.min.js.map 返回 200 且内容是合法 JSON（含 version、sources、mappings 字段）
- 检查 JS 文件末尾：右键“查看页面源代码”，搜索 sourceMappingURL，确认路径正确（相对路径基于 JS 文件位置解析）
- 避免跨域：.map 文件必须与 JS 同源，或服务端返回 Access-Control-Allow-Origin: *
在原始源码中下断点，实际停在压缩代码上
你直接点击原始文件（如 src/utils.js）某一行左侧空白处加断点，DevTools 会自动将该位置转换为压缩文件中的对应位置。运行时触发断点后：
立即学习“Java免费学习笔记（深入）”；
- 右侧 Scope 面板显示的是当前作用域的真实变量值（非压缩名，如 userList 而非 t）
- Call Stack 显示原始函数名和文件路径
- Console 中输入变量名，也能取到值；但注意：某些优化（如内联、死代码消除）可能导致原始变量在压缩后不存在，此时会显示 not available
- 若断点未命中，尝试刷新页面并勾选 DevTools 的 Settings → Preferences → Enable JavaScript source maps
常见问题与绕过技巧
当 SourceMap 失效但又急需调试压缩代码时：
- 在压缩文件里手动搜函数名或关键字符串，找到大致位置，用 debugger 语句插入（上线前记得删掉）
- Chrome 的 Pretty print ({} ) 按钮可格式化压缩 JS，虽仍是混淆名，但至少能看清结构、加断点、观察堆栈
- 用 console.log + new Error().stack 快速定位调用链
- 确认没有启用浏览器缓存：勾选 DevTools 的 Disable cache，或用无痕窗口测试
