VSCode中Node.js调试问题可通过五步解决：一、配置launch.json指定入口文件并启用sourceMaps；二、启用Microsoft官方Node Debug扩展；三、确保Node.js版本≥v14.18.0且VSCode调用正确路径；四、在可执行行设实心断点并F5启动；五、调试暂停后在控制台执行JS命令动态调试。

如果您在VSCode中编写Node.js应用时遇到无法启动调试、断点不生效或控制台无输出等问题，可能是由于调试配置缺失或环境设置不正确。以下是解决此问题的步骤：

本文运行环境：MacBook Air，macOS Sequoia。

一、配置launch.json调试文件

VSCode通过launch.json定义调试行为，需为Node.js项目创建专用的调试配置，否则调试器无法识别入口文件和运行参数。

1、打开项目根目录，在VSCode中按下Cmd+Shift+P（Mac）或Ctrl+Shift+P（Windows/Linux），输入“Debug: Open launch.json”并回车。

2、选择“Node.js”环境，VSCode将自动生成一个包含默认配置的.vscode/launch.json文件。

3、确认configurations数组中存在program字段，其值应指向主入口文件，例如"${workspaceFolder}/index.js"。

4、如需启用源码映射支持TypeScript或ESM，将sourceMaps设为true，并将outFiles指向编译输出目录。

二、安装并启用Node.js调试扩展

VSCode内置Node.js调试支持，但部分高级功能（如自动附加到子进程、Worker线程调试）依赖于官方Node.js扩展提供增强能力。

1、点击左侧活动栏的扩展图标（四个方块组成的图标）。

2、在搜索框中输入@builtin node-debug，找到名为“Node Debug”且作者为“Microsoft”的扩展。

3、若状态显示“已禁用”，点击“启用”按钮；若未安装，点击“安装”。

4、重启VSCode使扩展完全加载。

三、检查Node.js版本与运行时兼容性

调试功能依赖Node.js运行时的--inspect协议支持，低版本Node.js（如v8.0以下）可能缺少必要调试接口或存在协议不兼容问题。

1、在终端中执行node --version，确认输出版本不低于v14.18.0。

2、若版本过低，前往官网下载并安装最新LTS版Node.js。

3、在VSCode集成终端中运行which node（Mac/Linux）或where node（Windows），验证VSCode调用的是预期版本的Node可执行文件。

四、设置断点并启动调试会话

断点是调试的核心交互方式，必须在代码可执行行上设置，且确保调试配置中的program路径与实际运行路径一致，否则断点将显示为空心圆表示未绑定。

1、在目标JavaScript文件中，点击行号左侧空白区域设置断点，出现实心红点即表示激活。

2、按Cmd+D（Mac）或Ctrl+D（Windows/Linux）打开调试面板，从下拉菜单中选择已配置的启动项（如“Launch Program”）。

3、点击绿色三角形“开始调试”按钮，或按F5快捷键启动调试会话。

4、程序运行至断点处将自动暂停，此时可在“变量”面板查看作用域内所有值，在“调试控制台”中执行表达式。

五、使用调试控制台执行动态命令

调试控制台允许在暂停状态下直接运行JavaScript代码，用于验证逻辑、修改变量或触发函数，无需重启调试会话。

1、调试暂停后，确保焦点位于调试控制台（可通过Cmd+Shift+Y快速切换）。

2、输入任意合法JavaScript语句，例如process.env.NODE_ENV，按回车执行并查看返回值。

3、如需修改局部变量，直接赋值即可，例如count = 100，后续继续执行时将使用新值。

4、输入.help可查看可用的特殊命令列表，包括.clear清空历史、.break设置临时断点等。