断点进 node_modules 停不住？先关 sourceMaps：在 launch.json 中设 "sourceMaps": false 并配置 "skipFiles": ["<node_internals>"]，避免因缺失 source map 导致断点失效。
断点进 node_modules 但停不住？先关 sourceMaps
VSCode 默认拒绝在 node_modules 里设有效断点，尤其当包是纯 JS、没 sourceMappingURL 注释、也没 .map 文件时。它不是“不支持”，而是调试器默认开启 source map 映射校验，没 map 就直接放弃映射——断点变空心圆、hover 显示 Unbound Breakpoint 就是典型表现。
最直接的解法是告诉 VSCode：“别找 map，就用当前加载的 JS 文件当源码”。在 .vscode/launch.json 的配置里加两行：
-
"sourceMaps": false—— 强制禁用所有 source map 解析逻辑 -
"skipFiles": ["<node_internals>/**"]</node_internals>—— 去掉默认跳过内置模块的干扰（注意不是["/**"]，后者会把所有文件都跳过）
同时确认 "outFiles" 字段没包含 node_modules 相关路径，比如 "outFiles": ["./dist/**/*.js"] 是安全的；若写成 "outFiles": ["**/*.js"]，VSCode 可能主动忽略 node_modules 下的文件。
ESM 包进不去？检查 package.json 的 exports 入口
Node.js 的 exports 字段会覆盖 main 和 browser，而 VSCode 调试器只认后两者作为入口定位依据。如果一个包用了 "exports": { ".": "./dist/index.js" } 却没同步声明 "main": "./dist/index.js"，调试器启动时可能根本找不到入口文件，program 配对失败，连进程都起不来。
验证方式很简单：在终端运行 node --print "require.resolve('pkg-name')"，看输出路径是否和你期望被调试的文件一致。如果不一致，要么给包提 PR 补 main，要么临时在项目里手动改 node_modules/pkg-name/package.json 加上 "main": "./dist/index.js"（仅调试用）。
TS 编译包想断进 .ts？别依赖 npm install，用 npm link
装在 node_modules 里的 TypeScript 包，通常只有 .d.ts 和编译后的 .js，没有 .ts 源码和 .js.map。这时候硬开 sourceMaps: true 没用——因为压根没 map 文件可读。
真正可行的路是绕过 npm install 的产物，把源码软链接进来：
- 进该包源码目录，运行
npm link - 进你的项目目录，运行
npm link pkg-name - 确认
node_modules/pkg-name是个软链接，指向本地源码路径 - 确保该包源码根目录有
tsconfig.json，且"sourceMap": true已启用
这样 VSCode 启动时就能读到 .ts 文件 + 对应 .js.map，断点自然落在源码行，而不是编译后混乱的 var _a, _b 上。
断点进了但变量看不到？检查 Node 版本和 resolveSourceMapLocations
即使断点能停住，也可能出现 console.log 正常但调试面板里变量全灰色、this 是 undefined、闭包变量无法展开的情况。这往往不是配置问题，而是底层 V8 的限制。
两个关键点必须核对：
-
Node.js版本是否 ≥14.18？旧版本对 ESM + inline source map 支持不全，容易丢上下文 -
launch.json中是否存在"resolveSourceMapLocations"字段？如果存在，确认它没 excludenode_modules，例如"!**/node_modules/**"这种写法会直接让调试器放弃解析该路径下的所有 map
另外，某些包用了 eval 或动态 require 加载逻辑，V8 无法为其生成有效符号表——这种属于语言机制限制，再怎么配 launch.json 也无解，只能靠 debugger 语句 + 控制台手查。
