VSCode调试第三方包需启用sourceMaps并正确配置resolveSourceMapLocations、skipFiles和outFiles，ESM包还需检查sources路径及exports入口，修改launch.json后必须重启调试会话。
VSCode调试时第三方包进不去源码，node_modules里全是转译后代码
默认情况下，VSCode调试器会停在 node_modules 里的 .js 文件（比如 lodash/index.js），而不是你想要的原始 .ts 或带 sourceMap 的构建产物。这不是断点没打对，是调试器根本没加载源映射。
关键要确认两点：该包是否发布了 sourceMap（看 package.json 里有没有 "types" 或 "sourceMappingURL" 字段），以及你的 launch.json 是否启用了源映射支持。
- 确保
launch.json中"sourceMaps": true已开启（Node.js 调试必选项） - 如果包用 TypeScript 编写且发布了
.d.ts和.js.map，但 VSCode 还是跳不进源码，大概率是路径映射失败——这时得手动加"resolveSourceMapLocations" - 示例配置片段：
"resolveSourceMapLocations": ["../node_modules/**", "!../node_modules/@types/**"]
，告诉调试器去哪找 map 文件（注意路径相对于生成后的.js文件位置）
skipFiles 配置写错导致调试直接跳过整个依赖包
skipFiles 不是用来“跳过不想看的包”的黑名单，而是“跳过确定不需要调试的底层运行时文件”的白名单过滤器。写宽了，lodash、axios 全被跳过；写窄了，又会卡在 internal/* 或 node:fs 里出不来。
- 常见错误写法：
["node_modules/**"]—— 这会跳过所有第三方模块，包括你想调试的那个 - 正确思路：只跳
node:内置模块和真正无关的辅助脚本，比如："skipFiles": ["<node_internals>/**", "node:/**", "**/dist/test/**"]</node_internals>
- 如果你只想跳过某个包（如
webpack），但保留lodash可调试，就别动skipFiles，改用trace+ 断点条件或stepOver手动绕过
启用黑盒脚本（Black Box）后断点失效或无法单步进入
VSCode 的黑盒功能本质是让调试器忽略指定脚本的执行上下文，但它和 skipFiles 是两套机制，混用容易冲突。尤其当你在 launch.json 里配了 skipFiles，又在 DevTools 里手动黑盒了同一个路径，VSCode 可能直接放弃加载其 sourceMap。
- 黑盒适合临时屏蔽某段已知稳定的代码（比如某个 polyfill），不是长期跳过
node_modules的方案 - 在 VSCode 中启用黑盒需通过设置面板：Debug → Black Box Patterns → Add Pattern，填入类似
node_modules/lodash-es/**的 glob，而非正则 - 注意：黑盒模式下，即使你在源码里打了断点，调试器也不会停；但
F11（Step Into）仍可能意外跳进去——因为黑盒只影响“暂停”，不影响“执行流”
调试 ESM 包时 sourceMap 不生效，debugger 指令也不触发
ESM 环境下，Node.js 对 sourceMap 的解析更严格。很多 ESM 包（尤其是用 vite 或 esbuild 构建的）生成的 .js.map 里 sources 字段是相对路径（如 ../../src/index.ts），而 VSCode 默认从 outDir 开始解析，找不到源文件就会静默失败。
- 检查
.js.map文件中的sources值是否可访问（用绝对路径或补全"sourceRoot"） - 在
launch.json中显式指定"outFiles"，例如："outFiles": ["${workspaceFolder}/node_modules/my-pkg/dist/**/*.js"] - 若包使用
exports字段分发 ESM/CJS，确保你import的是带sourceMap的入口（有些包把 map 放在./dist/esm/，但exports指向的是./dist/cjs/）
最常被忽略的一点：VSCode 调试器不会自动重载 launch.json 修改，改完必须重启调试会话，否则所有配置都是假的。
