能直接在 node_modules 第三方库源码断点，需禁用 sourceMaps 并移除 skipFiles 黑名单；对 TypeScript 包则需 npm link 源码、配置 resolveSourceMapLocations 映射路径。
直接进 node_modules 里的第三方库源码断点，不是“能不能”，而是“怎么绕过 VSCode 默认跳过它的机制”。默认情况下它根本不会加载那些文件的调试信息，断点变空心、hover 显示 Unbound Breakpoint、控制台报 Breakpoint ignored because generated code not found——全是这个原因。
为什么断点进不去 node_modules
VSCode 调试器（js-debug）默认把 node_modules 列在 skipFiles 黑名单里，且强依赖 source map 对齐。但多数 npm 包：要么没带 sourceMappingURL 注释，要么只放编译后 JS、不放 .map，要么用 ESM + exports 字段导致入口路径不被识别。结果就是：V8 加载了代码，但调试器压根不知道该映射到哪，断点自然悬空。
-
skipFiles默认含"/**"或"<node_internals>/**"</node_internals>，会连带屏蔽node_modules -
sourceMaps: true开着时，若找不到对应.map文件，VSCode 直接放弃映射，不 fallback 到原始 JS - ESM 包若只导出
exports字段、没配main或browser，调试器无法确定入口文件位置
禁用 source map + 放开 skipFiles 最快生效
适用于纯 JS 包（如早期版本的 lodash、axios），或你确认包里没 .map 也懒得补。核心是让调试器“别挑”，直接把已加载的 JS 当源码用：
- 在
.vscode/launch.json的配置里加："sourceMaps": false - 显式覆盖默认跳过逻辑：
"skipFiles": ["<node_internals>/**"]</node_internals>（去掉"/**"这种宽泛写法） - 删掉或注释掉
outFiles字段——它常包含"${workspaceFolder}/node_modules/**"，会主动忽略 - 确保
program指向你的入口文件（如"${workspaceFolder}/index.js"），且已启动调试（F5，不是右上角绿色三角）
改完重开调试会话，再点 node_modules/some-pkg/index.js 行号左侧设断点——这次应该是实心红点。
想断进 TypeScript 包源码？用 npm link + 源码目录
对带 .ts 源码和 tsconfig.json 的包（如 @angular/core、zod），硬调编译后代码效率低。最稳的是把源码软链接进来，让 VSCode 读到真实 .ts 和 .js.map：
- 进该包源码根目录，运行
npm link - 进你的项目目录，运行
npm link <package-name>（如npm link zod） - 检查
node_modules/<package-name>是否为软链接（macOS/Linux 用ls -l，Windows 用dir看<SYMLINK>） - 确认包内
tsconfig.json有"sourceMap": true，且没开"inlineSourceMap": true - 你的项目
launch.json保持"sourceMaps": true，并加"resolveSourceMapLocations": ["${workspaceFolder}/../<package-name>/src/**", "!**/node_modules/**"]
这样断点打在 node_modules/<package-name>/src/xxx.ts 上，就能停住、看变量、步进，和调试自己代码无异。
断点进了却不停？优先查这三个地方
实心红点 ≠ 一定能停。常见卡点不在配置，而在运行时状态：
-
resolveSourceMapLocations路径写错：比如包源码在../packages/zod/src，但配置里漏了packages/，VSCode 就找不到映射目标 - Node.js 版本太新（v20+）或模块缓存干扰：重启 VSCode + 终端里
node --trace-warnings看是否报ERR_MODULE_NOT_FOUND类错误 - 包用了动态
import()或require()加载逻辑，断点行实际没被执行——用DEBUG=* node index.js确认模块是否真被 require 进来了
真正麻烦的永远不是“怎么设”，而是“为什么设了还不停”；每次遇到空心断点，先看状态栏有没有「调试正在运行」，再打开调试控制台搜 Loaded source map from，没这行日志，说明前面所有配置都白搭。
