VSCode断点不进依赖包主因是skipFiles默认屏蔽node_modules，需删掉相关规则或添加“!/node_modules/xxx/”放行；Promise异常需单独启用Uncaught Promise Rejections断点，sourceMaps对无map文件的包无效。

为什么断点打在依赖包里根本不停

VSCode 默认跳过 node_modules 里的代码，不是它不支持调试，而是 launch.json 里 skipFiles 配置默认把所有第三方路径都屏蔽了。你看到断点是空心圆、hover 提示 “breakpoint ignored”，大概率就是这个原因。

想进依赖包看抛错现场，必须显式告诉调试器“别跳过这些文件”：

• skipFiles 列表里删掉 "**/node_modules/**" 或整个字段（不写就默认不禁用）
• 或者更安全的做法：保留跳过大部分，只放行你要调试的包，比如 "!**/node_modules/axios/**"
• 注意顺序：skipFiles 是白名单逻辑，“!” 开头表示“不跳过”，多个规则按顺序匹配，第一条生效

依赖包里的 Promise.reject() 为什么没中断

Node.js 调试器默认只拦截同步未捕获异常，Promise.reject() 属于异步未处理拒绝（unhandled rejection），不会触发 Uncaught Exceptions 断点——这是最常见的漏配点。

必须手动启用 Promise 异常监听：

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

• 打开「运行和调试」面板 → 「断点」区域 → 点击「+」→ 选择 Node.js: Uncaught Promise Rejections
• 或者调试时点击右上角 ⋯ → 勾选 Uncaught Promise Rejections
• 注意：这个开关和 Uncaught Exceptions 是两个独立开关，缺一不可

launch.json 里哪些配置真影响依赖包异常捕获

exceptions 字段在 Node.js 调试中基本无效——VSCode 的 Node 调试器不读这个配置项，它只认 UI 里勾选的异常断点。但以下几项直接影响你能否看到依赖包里的错误上下文：

• console: 必须设为 "integratedTerminal"，否则异常堆栈可能只输出到外部终端，调试控制台看不到完整调用链
• env: 如果依赖包行为受环境变量控制（比如某些 SDK 的 debug 模式），得在这里透传，例如 "NODE_OPTIONS": "--trace-warnings"
• sourceMaps: 对已做 source map 的包（如 axios、lodash-es）有用，但多数 npm 包没提供 .map 文件，别指望能直接跳转到源码

进了 node_modules 却停在编译后代码里

你确实进了依赖包，但断点停在 node_modules/xxx/lib/index.js 这种压缩/编译产物上，而不是原始 TypeScript 或 ES 源码——说明 source map 链路断了，或者包本身没发布 map 文件。

能做的有限但关键：

• 先确认该包是否发布 source map：进 node_modules/xxx/ 目录，找 .js.map 文件，没有就别强求源码级调试
• 有 map 文件但断点错位？检查 launch.json 中 outFiles 是否包含该包路径，比如加 "${workspaceFolder}/node_modules/xxx/lib/**/*.js"
• 更现实的做法：在调用依赖的地方打断点，用「调用栈」面板往上翻，找到你自己的代码哪一行触发了它，再结合依赖文档或 GitHub issue 定位问题

依赖包异常最麻烦的从来不是“怎么停”，而是“停住了却看不懂上下文”——它没源码、没注释、调用链深、变量名被压缩。真正有效的调试，往往靠的是在自己代码里提前拦截、加日志、缩小触发条件，而不是硬啃 node_modules 里的黑盒。