vscode调试node.js时应配置skipfiles数组屏蔽node_modules和内置模块断点，推荐值为["/node_modules/", "/dist/", "/lib/", "/out/", "/build/", "/**"]，修改后需重启调试会话。
VSCode调试时 node_modules 和内置模块总打断点，怎么跳过？
默认调试 Node.js 时，VSCode 会把断点打到 require 加载的任何地方，包括 node_modules 里的包、甚至 fs path 这类内置模块内部——这不是你写的代码，跳进去只会浪费时间。
核心解决方式是配置 skipFiles，它告诉调试器“这些路径下的文件，一律不单步进入、不命中断点”。注意：它不影响你在自己代码里设的断点，只屏蔽跳转和停靠行为。
-
skipFiles是launch.json中的顶层字段，不是args或env的子项 - 值必须是数组，每个元素是 glob 模式（支持
**、*、?），不是正则 - 模式匹配的是**文件绝对路径**，所以
"node_modules/**"能生效，但"./node_modules/**"不能 - 内置模块如
fs实际由 V8 加载，路径形如/path/to/node/out/Release/obj/gen/node_javascript.cc，无法直接写死；得靠通配符覆盖常见位置
skipFiles 推荐配置项（Node.js 项目通用）
以下配置能覆盖绝大多数干扰场景，包括本地 node_modules、全局安装的包、以及常见内置模块源码路径：
"skipFiles": [ "**/node_modules/**", "**/dist/**", "**/lib/**", "**/out/**", "**/build/**", "<node_internals>/**" ] </node_internals>
"<node_internals>/**"</node_internals> 是 VSCode 特殊占位符，专为屏蔽 fs path events 等内置模块的 JS 层封装而设，比手动写一堆路径更可靠。它从 VSCode 1.46+ 开始支持，老版本请用 "**/internal/**" + "**/lib/internal/**" 补充。
- 如果你用的是 TypeScript，还要加
"**/*.d.ts"，否则跳转类型定义时可能意外停住 - 某些工具链（如 Jest）会在内存中生成临时文件，路径含
jest-transform-cache，可追加"**/jest-transform-cache/**" - 别写
"**/node_modules/*/**"——多一个*会导致 glob 不匹配，VSCode 会静默忽略整条规则
为什么改了 skipFiles 还是跳进 node_modules？
常见原因不是配置错，而是调试器没重新加载或路径没匹配上：
- 改完
launch.json后必须重启整个调试会话（Stop → Start Debugging），热重载不生效 - 确认你编辑的是当前调试使用的配置——检查左上角调试面板选中的配置名，不是随便一个
launch.json - 用
console.log(__filename)打印出问题文件的绝对路径，再对照skipFiles中的 glob 规则，看是否真能匹配（比如路径含空格或特殊字符时，某些 shell 环境下 glob 可能失效） - 如果用了
sourceMapPathOverrides，且映射后路径脱离了原始结构，skipFiles可能失效；此时优先保证sourceMapPathOverrides映射准确，再调整 skip 规则
跳过之后，想临时进去看一眼怎么办？
skipFiles 是静态屏蔽，但调试时总有例外需求——比如你想查某个第三方库的某次调用逻辑。这时有两个快捷方式：
- 在代码里右键点击函数名 → 选 Go to Definition，它走的是语言服务，不受
skipFiles影响 - 调试中按
F11单步进入前，按住Ctrl（Windows/Linux）或Cmd（macOS），就能强制进入当前行调用的目标函数，哪怕它在node_modules里 - 临时注释掉
skipFiles数组中对应条目，重启调试——比反复删改配置快，适合一次性排查
真正难处理的是那些被 Webpack/Vite 打包后内联的 node_modules 代码，它们没有独立文件路径，skipFiles 失效；这种时候只能靠 debugger 语句精准埋点，绕过自动跳转逻辑。
