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。
本文档主要讲述的是Eclipse下的Android-NDK安装;Android NDK 是运行于Android 平台上的Native Development Kit 的缩写。Android 应用开发者可以通过NDK 调用C 或C++ 本地代码。NDK 编译需要用到Cygwin 中的make 和gcc, 所以先来下载并安装Cygwin。希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看
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设置临时断点等。









