VS Code无法调试Node.js Hello World程序，求排查方案

问题描述 #

按照VS Code官方Node.js教程创建了简单的app.js文件：

var msg = 'Hello World';
console.log(msg);

终端执行node app.js可正常输出，但调试时（设置断点后按F5选择Node.js调试器）仅短暂显示调试菜单，调试控制台打印C:\Program Files\nodejs\node.exe .\app.js，状态栏闪蓝后恢复，无调试光标、无程序输出。

已尝试的操作：

• 配置标准launch.json文件（内容如下）

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "node",
            "request": "launch",
            "name": "Launch Program",
            "skipFiles": [
                "<node_internals>/**"
            ],
            "program": "${workspaceFolder}\\app.js"
        }
    ]
}

• 添加"stopOnEntry": true、"trace": true配置
• 查看DAP消息确认断点设置成功，但问题未解决

环境信息：Windows11系统，Node.js v23.3.0，VS Code 1.95.3（VSCodium也出现相同问题），两者均已加入系统路径

排查步骤 #

1. 切换Node.js到LTS版本 #

Node.js v23为开发版（Current分支），可能存在调试协议兼容性问题：

• 使用nvm安装LTS版本：nvm install --lts
• 切换到LTS版本：nvm use --lts
• 重启VS Code后重新测试调试

2. 确认工作区根目录正确性 #

确保VS Code打开的是app.js所在的文件夹而非单个文件：

• 关闭当前窗口，重新打开目标文件夹
• 可在调试控制台执行echo ${workspaceFolder}，验证路径是否指向app.js所在目录

3. 禁用冲突扩展 #

部分扩展可能干扰调试器运行：

• 打开扩展面板（Ctrl+Shift+X），禁用所有非官方扩展（尤其是Node.js调试、进程管理类扩展）
• 重启VS Code后测试调试功能

4. 重置调试配置 #

• 删除.vscode/launch.json文件
• 按F5重新初始化调试配置，选择"Node.js"选项
• 不手动修改配置，直接启动调试验证

5. 检查系统权限与杀毒软件 #

• 右键以管理员身份运行VS Code，确保进程有足够权限
• 暂时禁用Windows Defender或第三方杀毒软件的实时保护，排查是否被拦截

6. 验证Node.js原生调试功能 #

手动启动调试模式，确认Node.js本身的调试功能正常：

• 终端执行node --inspect-brk app.js
• 复制终端输出的调试链接（如ws://127.0.0.1:9229/xxxx）
• 在Chrome浏览器打开chrome://inspect，添加localhost:9229后查看是否能连接并触发断点

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