首先确认Node.js和VSCode环境已就绪,1. 安装必要组件并验证;2. 在项目根目录创建.vscode/launch.json配置调试参数如program指向主文件;3. 在代码中设置断点后通过F5启动调试;4. 可通过args传参或配置runtimeExecutable调试npm脚本。

要调试一个简单的 Node.js 应用,VSCode 提供了强大的内置支持。只需正确配置启动设置,就可以轻松打断点、查看变量和逐步执行代码。
1. 确保环境准备就绪
确认你已经安装了以下内容:
- Node.js(可通过命令行运行 node -v 验证)
- VSCode 编辑器
- 在 VSCode 中安装了官方的 JavaScript 和 Node.js 调试扩展(通常默认已安装)
你的项目中应包含一个简单的入口文件,比如 app.js 或 index.js。
2. 创建调试配置文件 launch.json
在项目根目录下创建 .vscode 文件夹,并添加 launch.json 文件来定义调试行为。
步骤如下:
- 打开 VSCode,进入“运行”视图(快捷键 Ctrl+Shift+D)
- 点击“创建 launch.json 文件”
- 选择环境为 Node.js
生成的配置示例:
{ "version": "0.2.0", "configurations": [ { "type": "node", "request": "launch", "name": "调试 Node.js 应用", "program": "${workspaceFolder}/app.js", "outFiles": [ "${workspaceFolder}/**/*.js" ], "console": "integratedTerminal", "skipFiles": [ "说明:
- program 指向你的主文件,根据实际文件名调整
- console 设为 integratedTerminal 可在终端中看到输出
- skipFiles 忽略 Node 内部代码,避免误入
3. 设置断点并启动调试
打开你的主 JS 文件(如 app.js),在你想暂停执行的某一行左侧点击,设置一个断点(红点出现即可)。
Vuex是一个专门为Vue.js应用设计的状态管理模型 + 库。它为应用内的所有组件提供集中式存储服务,其中的规则确保状态只能按预期方式变更。它可以与 Vue 官方开发工具扩展(devtools extension) 集成,提供高级特征,比如 零配置时空旅行般(基于时间轴)调试,以及状态快照 导出/导入。本文给大家带来Vuex参考手册,需要的朋友们可以过来看看!
回到“运行”视图,选择“调试 Node.js 应用”,然后点击绿色三角按钮或按 F5 启动。
程序会在断点处暂停,你可以:
- 查看当前作用域的变量值
- 使用调试工具栏单步执行(逐行、跳入函数等)
- 在调试控制台中执行表达式
4. 调试常见脚本或带参数的应用
如果你需要传递命令行参数,可以修改 launch.json 中的 args 字段:
"args": ["--env", "development"]若要调试通过 npm script 运行的应用(如 npm start),可使用:
{ "type": "node", "request": "launch", "name": "通过 npm 启动", "runtimeExecutable": "npm", "runtimeArgs": ["run", "start"], "console": "integratedTerminal", "port": 9229 }基本上就这些。只要配置好 launch.json 并设置断点,VSCode 就能很好地调试大多数简单 Node.js 应用。不复杂但容易忽略的是路径和文件名是否匹配。









