如何在Visual Studio Code中关闭smartStep避免"Skipped by smartStep"提示

提示与smartStep功能说明 #

• 调试时出现的Skipped by smartStep是VS Code JavaScript/TypeScript调试器的功能触发标记，不是程序运行错误。
• smartStep是该调试器默认开启的单步调试优化功能，设计初衷是减少调试时的无效停留：自动跳过没有有效源码映射（source map）的第三方依赖代码、编译生成的中间代码（比如node_modules下的压缩代码、TS编译生成的JS中间文件），让单步调试时可以直接落在开发者自己编写的业务源码位置，不用反复手动步过无意义的第三方代码。
• 你遇到的非预期停在node_modules目录下的问题，是smartStep的匹配逻辑偏差导致的：当项目源码映射配置不全、或者部分第三方依赖携带了不规范的source map路径时，调试器会误将部分依赖代码判定为和业务源码关联的执行链路，在自动步进过程中短暂停在这些位置，属于该功能的已知边界问题。

关闭smartStep的操作方法 #

1. 打开VS Code左侧调试面板，点击当前调试配置旁的齿轮图标，打开项目根目录下的.vscode/launch.json配置文件。
2. 在你正在使用的Node.js调试配置项中，添加"smartStep": false配置字段，参考示例：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "调试Node服务",
      "program": "${workspaceFolder}/index.js",
      "smartStep": false
    }
  ]
}

3. 保存配置后重启调试会话，smartStep会完全失效，调试器仅会在你手动设置了断点的位置停留，不会触发自动步进跳过逻辑，也不会出现对应提示。

保留smartStep能力的优化方案 #

如果不想完全放弃smartStep跳过无意义代码的能力，仅需要解决误停node_modules的问题，可以搭配skipFiles配置明确指定调试器需要强制跳过的路径，参考配置：

{
  "type": "node",
  "request": "launch",
  "name": "调试Node服务",
  "program": "${workspaceFolder}/index.js",
  "smartStep": true,
  "skipFiles": [
    "${workspaceFolder}/node_modules/**/*.js",
    "<node_internals>/**/*.js"
  ]
}

该配置下smartStep会正常生效，同时调试器会完全跳过node_modules下所有文件、Node.js内置模块文件，不会在这些路径出现非预期停留。

注意：如果关闭smartStep后你预设位置的断点依然没有命中，需要检查项目是否使用了TypeScript、Babel、打包工具做代码转译/编译，确认源码映射配置正确，否则调试器无法将你在源码上设置的断点，映射到实际运行的编译后代码对应位置。

内容的提问来源于stack exchange，提问作者user18668497