VSCode无法直接监听文件重启Node.js,必须用nodemon等外部工具;正确做法是在终端运行npx nodemon或封装为npm script,调试时需先启动nodemon再attach。

不能靠 VSCode 自己监听文件并重启 Node.js——它压根没这功能,必须用外部工具。 最稳、最常用、开箱即用的方案就是 nodemon,它专为这个场景设计,比手写 fs.watch 或依赖编辑器保存事件可靠得多。
为什么直接配 tasks.json 的 isBackground + watch 不行
很多人在 tasks.json 里设 "isBackground": true 并幻想“改了文件就自动重跑”,结果任务卡在“正在运行”,改完代码毫无反应。这是因为:
- VSCode 的 task 系统不监听文件系统,只响应你手动触发(比如
Ctrl+Shift+P → Run Task) -
problemMatcher是用来捕获输出日志的,不是监听磁盘变化的钩子 - 哪怕你配了
watch字段,那也只是 TypeScript / Less 等少数语言的内置支持,对普通.js或.ts入口文件无效
正确做法:用 nodemon 启动 + 终端里跑命令
这是最轻量、最不易出错的路径,不需要改 VSCode 配置,也不依赖 launch.json:
- 项目内安装:
npm install --save-dev nodemon - 入口文件是
server.js?直接在 VSCode 集成终端里运行:npx nodemon server.js - 想监听
.ts文件?加-e ts,json参数:npx nodemon -e ts,json --exec ts-node src/server.ts - Windows 下路径含空格?
--exec值用双引号包住:--exec "ts-node \"src/server.ts\""
进阶:封装成 npm script + tasks.json 一键启动
如果你希望点一下就跑,而不是每次输命令,可以封装:
KeystoneJS 是一个功能强大的开源无头 CMS,适用于 Node.js,它根据您的模式定义自动生成 GraphQL API 和基于 React 的管理界面。由 Thinkmill 构建,支持 PostgreSQL 和 SQLite、自定义访问控制、钩子、虚拟字段和基于文档的富文本编辑。
- 在
package.json的scripts里加:"dev": "nodemon -e js,ts,json --exec ts-node src/server.ts" - 然后在
.vscode/tasks.json里定义一个 task:
{
"version": "2.0.0",
"tasks": [{
"label": "start:dev",
"type": "shell",
"command": "npm run dev",
"group": "build",
"isBackground": true,
"problemMatcher": []
}]
}
注意:problemMatcher 必须为空或删掉,否则 VSCode 会等它匹配日志才认为任务“启动成功”,而 nodemon 是长期运行的,永远等不到结束信号。
调试时别让 nodemon 和 VSCode 调试器打架
如果要边热重载边调试,--inspect-brk 是刚需,且必须用 attach 模式:
- 先确保
package.json有脚本:"debug": "nodemon --inspect-brk src/server.ts" - 终端里先运行:
npm run debug,等看到Debugger listening on ws://127.0.0.1:9229/ - 再在
.vscode/launch.json里配一个 attach 配置,关键字段只有三个:"request": "attach"、"port": 9229、"restart": true - 别用
launch模式硬拉nodemon——VSCode 控不住它的进程生命周期,断点大概率失效
最容易被忽略的是顺序:必须先让 nodemon 跑起来、打开调试端口,VSCode 才能连上;反过来点绿色三角,它只会一直“等待连接”。










