如何在 VSCode 中通过 launch.json 调试 Node.js 服务端代码

云辰大大_1792

云辰大大_1792

2026-07-17

527人浏览

原创

type字段必须为小写"node",填"nodejs"或"javascript"均报错;program须指向可执行js文件(如"${workspacefolder}/src/server.js"),不可写npm命令;express等服务需设"autoattachchildprocesses": false以防断点错乱。

如何在 vscode 中通过 launch.json 调试 node.js 服务端代码

launch.json 里 type 字段必须是 node,不是 nodejs 或 javascript

VSCode 调试器识别 Node.js 环境靠的是 type 字段,填错就直接报错 Configured debug type 'nodejs' is not supported。常见错误是凭直觉写成 nodejs,或从旧文档抄来过时的 javascript —— 这俩都不生效。

  • type 只能是 node(小写,无后缀)
  • 对应调试器是 VSCode 自带的 Node.js Debug Adapter,无需额外安装插件(除非用旧版 VSCode)
  • 如果项目用 TypeScript,type 仍是 node,但需配合 preLaunchTask 或 outFiles 指向编译后代码

program 字段要指向可执行的 JS 入口文件,不是 package.json 的 script

program 是调试器真正启动的文件路径,必须是 .js 文件(或经 ts-node 编译的 .ts),不能写 npm run dev 或 yarn start —— 那些是 shell 命令,VSCode 不会解析。

Wjs Uploading Video
Wjs Uploading Video

将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。

下载
  • 正确示例:"program": "${workspaceFolder}/src/server.js"
  • 错误示例:"program": "npm run dev"(会报错 spawn npm ENOENT)
  • 若用 nodemon,得换用 runtimeExecutable + runtimeArgs,而不是塞进 program
  • 路径支持变量,如 ${workspaceFolder}、${file},但别漏掉 ./ 前缀(相对路径需显式声明)

调试 Express/Koa 服务时,必须关掉 autoAttachChildProcesses 或设为 false

Express 启动后常 fork 子进程(比如日志收集、热重载),VSCode 默认开启子进程自动附加(autoAttachChildProcesses: true),结果断点全乱套:命中位置不对、变量显示为空、甚至调试器卡死。

  • 显式加 "autoAttachChildProcesses": false 是最稳妥做法
  • 若真需要调试子进程(如 cluster 模式),改用 attach 模式 + processId 手动指定,而非依赖自动附加
  • 某些脚手架(如 Nest CLI)默认启用 watch,也会触发子进程,同样要关掉 autoAttachChildProcesses

修改 launch.json 后不生效?检查 configurations 是否被其他扩展覆盖

有些扩展(比如 REST Client、TypeScript 支持包)会往 .vscode/launch.json 里塞自己的配置块,VSCode 优先读取第一个 configurations 数组 —— 如果它被插件污染,你的配置可能根本没加载。

  • 打开命令面板(Ctrl+Shift+P),运行 Debug: Open launch.json,确认看到的是你编辑的文件
  • 删掉无关的 configurations 项,只留一个干净的 node 配置
  • 如果用多根工作区,注意 launch.json 在哪个文件夹下 —— 它只对所在文件夹生效
  • 改完保存后,务必重启调试会话(Stop → Start),热重载不会刷新 launch.json 解析结果
VSCode 的 Node.js 调试本身很稳定,但配置项之间有隐含依赖,比如 program 路径错了,env 里设再多环境变量也没用;autoAttachChildProcesses 开着,断点就大概率失效。这些不是玄学,是调试器启动链路上的真实约束。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

vscode node.js js json node

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
node.js调试
node.js调试

node.js调试可以使用console.log()输出调试信息、断点调试和第三方调试工具。详细介绍:1、console.log()输出调试信息,通过在代码中插入console.log()语句,开发人员可以在控制台输出变量的值、函数的执行结果等信息,以便观察代码的执行流程和状态;2、断点调试,可以在代码中设置断点,以便在特定位置暂停代码的执行,观察变量的值和执行流程等。

2023.09.19

10389

8

JavaScript 全栈开发基础(Node.js + 前端)
JavaScript 全栈开发基础(Node.js + 前端)

本专题系统介绍 JavaScript 在全栈开发中的核心知识结构,涵盖 Node.js 基础、Express/Koa 接口构建、前端交互设计、模块化与包管理、数据库连接、前后端数据通信与部署流程。通过完整项目示例,帮助学习者掌握从浏览器到服务器的一体化开发能力,实现真正意义上的全栈入门。

2025.11.26

434

14

Node.js后端开发与Express框架实践
Node.js后端开发与Express框架实践

本专题针对初中级 Node.js 开发者,系统讲解如何使用 Express 框架搭建高性能后端服务。内容包括路由设计、中间件开发、数据库集成、API 安全与异常处理,以及 RESTful API 的设计与优化。通过实际项目演示,帮助开发者快速掌握 Node.js 后端开发流程。

2026.02.10

761

17

JavaScript Node.js流处理与高效数据管道构建实践
JavaScript Node.js流处理与高效数据管道构建实践

本专题聚焦 Node.js 在大规模数据处理场景中的应用,系统讲解 Stream 流机制、背压控制、管道(Pipe)处理以及文件与网络数据流的高效传输方式。内容包括可读流、可写流、双工流与转换流的实现原理,并结合实际案例构建高性能数据处理管道,帮助开发者提升数据处理效率与系统吞吐能力。

2026.04.07

324

13

TypeScript Node.js 全栈工程化与Monorepo架构实践
TypeScript Node.js 全栈工程化与Monorepo架构实践

本专题围绕 TypeScript 在 Node.js 全栈开发中的工程化实践展开,系统讲解 Monorepo 架构设计、包管理策略、模块复用机制以及服务端与前端统一类型系统的构建方法。通过真实项目案例,帮助开发者提升大型全栈项目的可维护性与协作效率。

2026.06.16

578

8

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

2023.06.20

4236

8

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.28

1315

5

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1698

5

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

2023.08.17

9783

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程