Visual Studio Code中Express应用断点失效问题求助

我之前调试GOV.UK Prototype Kit时也碰到过一模一样的问题——start.js里的断点正常触发，但业务代码（比如./app/views/x/something.js）里的断点总显示灰色未验证，完全不生效。折腾了好一阵才搞定，给你几个靠谱的排查方向：

1. 优化launch.json的路径匹配配置 #

你的attach基础配置没问题，但可以补充source map相关规则，强制VSCode正确映射源文件路径。把launch.json改成这样试试：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "attach",
      "name": "Attach to GOV.UK Prototype",
      "processId": "${command:PickProcess}",
      "protocol": "inspector",
      "sourceMaps": true,
      "resolveSourceMapLocations": [
        "${workspaceFolder}/**",
        "!**/node_modules/**"
      ],
      "localRoot": "${workspaceFolder}",
      "remoteRoot": "${workspaceFolder}"
    }
  ]
}

resolveSourceMapLocations会限定VSCode只在你的项目目录内查找源文件，排除node_modules避免混淆；localRoot和remoteRoot确保本地路径与调试器识别的路径完全对齐，解决路径映射偏差问题。

2. 改用「Launch」模式调试 #

Attach模式的路径匹配偶尔会出问题，直接让VSCode启动应用并调试更稳妥。修改launch.json为启动配置：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch GOV.UK Prototype",
      "program": "${workspaceFolder}/start.js",
      "args": [],
      "sourceMaps": true,
      "console": "integratedTerminal"
    }
  ]
}

之后直接点击VSCode调试面板的启动按钮即可，不用手动执行npm start --inspect，VSCode会自动带调试参数启动应用，路径匹配的问题大概率能解决。

3. 检查启动脚本的参数传递 #

打开项目的package.json，看看start脚本的实际内容——如果用了nodemon这类进程管理工具，要确保--inspect参数能正确传递给Node进程。比如如果start脚本是nodemon start.js，你需要执行npm start -- --inspect（注意多一个--），这样参数才会传递给Node而非nodemon。

4. 核对文件路径的大小写 #

MacOS默认大小写不敏感，但Node调试器会严格区分路径大小写。比如你在VSCode里打开的是./app/views/X/something.js，但实际文件是./app/views/x/something.js，这种情况断点就会失效。检查一下设置断点的文件路径和实际文件系统的路径是否完全一致。

5. 清理调试缓存后重试 #

有时候VSCode的调试缓存会干扰断点识别，你可以：

• 关闭VSCode，备份后删除项目根目录下的.vscode/launch.json，再重新创建配置
• 清空终端，重启后再重新启动调试流程

我当时是用Launch模式加上调整source map配置搞定的，你可以先试试这个方案，应该能解决断点未验证的问题。

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