断点跳到混淆代码是因为sourcemap未被正确加载或映射失败，核心在于构建产物、路径匹配与调试器启用三者未对齐：需确认Chrome已加载sourcemap（Sources面板查webpack://结构）、sourceMappingURL存在且可访问、launch.json中sourceMaps:true和outFiles路径准确、webRoot与sourceMapPathOverrides正确拼接源码路径。
断点跳到混淆代码，不是 VSCode 配置错了，而是 sourcemap 没被正确加载或映射失败——核心问题在构建产物、路径匹配、调试器启用三者没对齐。
为什么 Chrome DevTools 里能跳原始文件，VSCode 里却停在 bundle.js 上
VSCode 不解析 sourcemap，它靠 Chrome 的调试协议把“原始文件位置”传过来；如果 Chrome 自己都没加载 sourcemap，VSCode 就收不到任何映射信息，只能退回到混淆后的代码行上断点。
- 打开 Chrome DevTools → Sources 面板 → 展开
webpack://或file://，看有没有你的src/目录结构；没有就说明构建根本没产出有效 sourcemap - 检查编译后的
index.js文件末尾是否有//# sourceMappingURL=index.js.map，且该路径能被浏览器访问（比如本地开发时，index.js.map必须和index.js同目录） - Webpack 用户注意：
devtool: 'eval-source-map'在 HMR 场景下容易断点偏移，换成'source-map'或'inline-source-map'更稳
launch.json 中 sourceMaps 和 outFiles 怎么填才不白配
sourceMaps: true 只是开关，真正决定“JS 映射到哪去”的是 outFiles —— 它告诉 VSCode：“这些 JS 是编译产物，请用它们的 .map 去反查源码”。填错路径，VSCode 根本不会尝试加载 sourcemap。
-
outFiles必须指向编译后的 JS 文件（不是 TS），例如：["${workspaceFolder}/dist/**/*.js"] - 如果打包输出多个目录（如
dist/es/+dist/cjs/），outFiles要全部覆盖，漏一个就可能断点失效 - 前端调试不用写
program字段；Node.js 调试才需要，且此时outFiles通常不生效，改用resolveSourceMapLocations - Vite 用户注意：
vite build默认关闭 sourcemap，必须在vite.config.ts中显式加build.sourcemap: true
webRoot 和 sourceMapPathOverrides 怎么避免路径拼错
VSCode 用 webRoot 去“解释” sourcemap 里的 sources 字段。比如 sourcemap 里写的是 webpack:///./src/main.ts，VSCode 就会拿 webRoot 拼出完整路径去找这个文件。拼错=找不到=断点灰掉。
-
webRoot应设为项目根目录（即vite.config.ts或webpack.config.js所在位置），不是src也不是dist - 常见错误：Webpack 输出用了绝对路径（如
/Users/name/project/src/main.ts），导致 sourcemap 里路径和本地不一致；统一用相对路径配置output.devtoolModuleFilenameTemplate - 如果 sourcemap 中
sources带了奇怪前缀（如webpack:///../src/或app://./src/），就得用sourceMapPathOverrides做重映射，例如："webpack:///./src/*": "${workspaceFolder}/src/*"
Chrome 启动参数和缓存怎么影响断点稳定性
即使所有配置都对，Chrome 自身行为也会让断点漂移或失效——尤其是热更新后不刷新页面、或调试端口被复用时。
- VSCode 必须用
type: "pwa-chrome"（不是旧版chrome），否则连接失败或映射丢失 - 启动 Chrome 时加上
--remote-debugging-port=9222 --user-data-dir=/tmp/chrome-debug，避免复用已有实例干扰 sourcemap 缓存 - 在 Chrome DevTools 中按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入Disable cache并启用 - 改完代码后，别只靠 HMR；手动刷新页面（
Cmd+R），再按Cmd+Shift+P→Debug: Restart Session，比关掉重连更快
真正卡住的地方往往不是 launch.json 写得不够全，而是 sourcemap 文件没生成、浏览器没加载、VSCode 拼路径时多了一级 ../、或者 Chrome 复用了带旧 map 缓存的进程——调一次不通，就逐个验证这四个点。
