切换Node.js版本后VSCode调试功能失效求助

问题背景 #

长期使用VSCode + Node.js v20.9.0调试正常，切换至Node.js v23.3.0并升级nvm到v1.1.12后，程序可运行但调试功能异常：

• 调试启动选项消失，仅能通过F5启动
• 调试控制台仅显示启动命令C:\Program Files\nodejs\node.exe .\index.js，无其他输出
• 无法触发断点，console.log内容不显示
• nvm list显示当前使用v23.3.0（64位），同时存在v20.9.0、v17.2.0版本
• 现有launch.json配置如下：

{
    // Use IntelliSense to learn about possible attributes.
    // Hover to view descriptions of existing attributes.
    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "type": "node",
            "request": "launch",
            "name": "Launch Program",
            "skipFiles": [
                "<node_internals>/**"
            ],
            "program": "${workspaceFolder}\\index.js",
            "cwd": "${workspaceRoot}"
        }
    ]
}

修复步骤 #

1. 对齐VSCode与nvm的Node.js版本 #

VSCode可能未自动识别nvm切换后的版本，需手动指定：

• 打开VSCode设置（快捷键Ctrl+,）
• 搜索Node: Path，将路径设置为nvm当前版本的Node.exe路径（示例：C:\Users\[你的用户名]\.nvm\versions\node\v23.3.0\bin\node.exe）
• 重启VSCode

2. 适配Node.js v23更新launch.json #

Node.js v20+调试协议有变化，调整配置确保兼容性：

• 添加runtimeExecutable指定nvm的Node命令，确保调用正确版本
• 设置console: "integratedTerminal"让输出显示在集成终端（而非调试控制台）
• 修改后的配置示例：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "node",
            "request": "launch",
            "name": "Launch Program",
            "skipFiles": ["<node_internals>/**"],
            "program": "${workspaceFolder}\\index.js",
            "cwd": "${workspaceFolder}",
            "runtimeExecutable": "nvm exec 23.3.0 node",
            "console": "integratedTerminal"
        }
    ]
}

3. 重置VSCode调试缓存 #

• 备份项目下的.vscode/launch.json后删除该文件
• 按下Ctrl+Shift+P执行Debug: Reset All Debug Configurations
• 重启VSCode后重新生成调试配置

4. 验证nvm与Node.js安装完整性 #

• 执行nvm uninstall 23.3.0卸载当前版本，再运行nvm install 23.3.0重新安装
• 若nvm v1.1.12与Node.js v23存在兼容性问题，可回退nvm到稳定版本（如v1.1.11）

5. 测试调试功能 #

• 设置断点后按F5启动调试
• 检查集成终端是否显示console.log输出，断点是否正常触发

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