1. 确认调试启动方式 #

必须通过VS Code的调试面板启动程序，不能在终端手动执行npm start或npm dev。手动启动的服务器进程无法被调试器挂载，断点自然不会触发。

2. 调整launch.json配置 #

根据你的使用场景，提供两种配置方案：

方案A：直接启动Node进程（对应npm start） #

添加调试协议字段适配Node v22，确保路径识别正确：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "node",
            "request": "launch",
            "name": "Launch Program",
            "skipFiles": ["<node_internals>/**"],
            "program": "${workspaceFolder}/index.js",
            "protocol": "inspector" // 明确指定调试协议，适配Node v22版本
        }
    ]
}

方案B：使用nodemon启动（对应npm dev） #

如果需要热重载，修改配置适配nodemon：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "node",
            "request": "launch",
            "name": "Dev with Nodemon",
            "runtimeExecutable": "nodemon",
            "program": "${workspaceFolder}/index.js",
            "restart": true,
            "console": "integratedTerminal",
            "skipFiles": ["<node_internals>/**"]
        }
    ]
}

3. 检查断点与代码执行逻辑 #

• 确认断点设置在可执行代码行：你在app.js的console.log("hit");行设置的断点是有效的，但要确保Postman调用的是GET /接口，且没有被其他中间件（如databaseConnectionMiddleware）提前拦截。
• 查看断点状态：如果断点显示为灰色空心圆，说明调试器无法识别该断点，尝试关闭并重新打开VS Code，或确认工作区根目录设置正确。

4. 排查端口与进程冲突 #

• 执行lsof -i :8081（Mac/Linux）或netstat -ano | findstr :8081（Windows），检查端口8081是否被其他进程占用，若占用则杀死对应进程后重新启动调试。
• 确保启动调试时，终端没有其他正在运行的服务器进程。

5. 适配Node.js v22的特殊设置 #

Node.js v22的默认特性可能影响调试，可添加环境变量配置：

"env": {
    "NODE_ENV": "development",
    "PORT": "8081"
}

如果代码中使用了实验性特性，暂时禁用相关标志（如--experimental-specifier-resolution=node）再测试。

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