Visual Studio非默认路径Node.js项目断点提示set but not yet bound问题

问题根因 #

从调试日志可以明确看出，Visual Studio的Node.js调试器自动生成的断点匹配正则固定指向了默认用户目录路径，和你实际存放项目的C:\workspace路径不匹配，导致断点无法绑定到已加载的脚本。

解决方法 #

• 修正调试配置路径 #

  右键你的Node.js控制台项目 → 点击「属性」→ 切换到「调试」选项卡，手动确认「工作目录」「启动文件」的路径和你实际项目存放路径完全一致，优先使用绝对路径填写，避免相对路径识别错误。

• 新增自定义调试启动配置 #

  在项目根目录手动创建launch.json文件，写入以下配置，强制指定调试器的工作路径和断点匹配规则：

  {
    "version": "0.2.0",
    "configurations": [
      {
        "type": "node",
        "request": "launch",
        "name": "启动Node.js控制台程序",
        "program": "${workspaceFolder}/app.js",
        "cwd": "${workspaceFolder}",
        "disableOptimisticBPs": true,
        "resolveSourceMapLocations": [
          "${workspaceFolder}/**",
          "!**/node_modules/**"
        ]
      }
    ]
  }
  

• 排查路径兼容性问题 #

  确认你存放项目的路径没有中文、空格、特殊符号，也不要出现路径大小写和实际磁盘目录不一致的情况，Windows系统路径虽默认不区分大小写，但Node.js调试器的正则匹配逻辑可能出现大小写识别偏差。

• 重置Node.js调试全局配置 #

  打开Visual Studio顶部菜单栏「工具」→「选项」→「项目和解决方案」→「Node.js工具」→「调试」，点击「重置所有调试设置」，重启Visual Studio后重新加载项目测试。

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