Node系列 · Express:nodemon

Node系列 · Express:nodemon

开发期每次改完代码都要手动重启 Node 太麻烦------nodemon 监听文件改动自动重启,让开发效率提升一个档次。

一、安装与基础使用

bash 复制代码
npm install -g nodemon      # 全局安装
# 或作为开发依赖
npm install -D nodemon

1.1 最简使用

bash 复制代码
# 替代 node 命令
nodemon app.js

# 指定端口
nodemon app.js --port 4000

nodemon 启动后:

  1. 执行 app.js
  2. 监听当前目录及子目录的文件变化
  3. 文件改了 → 自动重启进程
  4. 控制台输出 [nodemon] restarting due to changes...

1.2 监听特定文件

bash 复制代码
nodemon --watch src --watch config app.js

只监听 src/ 和 config/ 目录的变化。

1.3 忽略特定目录

bash 复制代码
nodemon --ignore node_modules --ignore '*.test.js' app.js

node_modules 默认就忽略,但日志、构建产物目录需要显式排除。

二、配置 nodemon.json

把配置写到 nodemon.json 比命令行更可维护:

json:nodemon.json 复制代码
{
  "watch": ["src", "config"],
  "ignore": ["src/**/*.test.js", "logs"],
  "ext": "js,json,env",
  "env": {
    "NODE_ENV": "development"
  },
  "exec": "node --inspect app.js"
}
配置项 含义
watch 监听哪些目录
ignore 忽略哪些文件
ext 触发重启的扩展名
env 注入环境变量
exec 实际执行的命令

三、package.json 集成

json:package.json 复制代码
{
  "scripts": {
    "start": "node app.js",
    "dev": "nodemon app.js",
    "debug": "nodemon --inspect app.js"
  }
}
bash 复制代码
npm run dev      # 启动 nodemon
npm run debug    # 启动 nodemon + 调试模式

四、调试模式(--inspect)

配合 Node Inspector / Chrome DevTools 调试:

bash 复制代码
nodemon --inspect app.js
text 复制代码
[nodemon] starting `node --inspect app.js`
Debugger listening on ws://127.0.0.1:9229/...

打开 Chrome DevTools → chrome://inspect,即可在浏览器里打断点、看变量。

五、--inspect vs --inspect-brk

bash 复制代码
# --inspect:启动后立即继续执行,断点命中时才停
nodemon --inspect app.js

# --inspect-brk:启动后第一行就暂停,等调试器连上
nodemon --inspect-brk app.js

--inspect-brk 适合"代码启动早期就要打断点"的情况。

六、与 Node 内置 --watch 对比

Node 18+ 内置 --watch 也能监听文件变化:

bash 复制代码
node --watch app.js
维度 nodemon node --watch
内置 ❌ 第三方 ✅ 内置
配置灵活度 高(nodemon.json) 低(仅 --watch-path)
多目录监听 ✅ ❌(单目录)
自定义扩展名 ✅ ❌(默认 js/json/mjs)
调试集成 --inspect 完整支持 需手动加
老项目兼容 通用 Node 18+

::: tip

新项目(Node 18+)可以直接用 node --watch ,少装一个依赖;老项目 / 需要复杂配置仍用 nodemon。

:::

七、最佳实践

场景 推荐
开发期启动 nodemon app.js 或 node --watch app.js
调试 nodemon --inspect app.js
监听多目录 nodemon.json 的 watch 数组
忽略日志 / node_modules nodemon.json 的 ignore
注入环境变量 nodemon.json 的 env.NODE_ENV = 'development'

八、小结

  • nodemon 监听文件改动自动重启 Node 进程
  • 配置文件 nodemon.json 比命令行参数更可维护
  • --inspect 启动 Node Inspector,配合 Chrome DevTools 调试
  • Node 18+ 可用内置 node --watch 替代,少装依赖
  • 大项目用 nodemon.json 配置监听目录和忽略规则
相关推荐
用户216076340837 小时前
一个 2 MB 的 .zst 文件,解压出来只有十几 KB
node.js
木头左1 天前
【浏览器自动化】用 CDP 接管本机 Chrome:从一个宿主迁到另一个宿主的设计与踩坑
node.js·浏览器自动化·cdp·技能化·踩坑实践
cpolar技术支持2 天前
把 agent-autoloop 装在 Mac 上:用本机 Node 实跑一次「接活—提问—拍板—接着干」,再用 cpolar 把它的状态页开给不在工位的自己
node.js·内网穿透·cpolar·ai agent·agent-autoloop
SEO_juper2 天前
Node.js 全站 SEO 体检报告生成器:一次查完标题、描述、canonical、H1、图片
开发语言·前端·node.js·html·bash
木头左3 天前
【Node.js】Markdown 转带图片 Word 文档实战:docx 库转换器设计与 5 个踩坑
node.js·word·markdown·文档自动化
思特奇时空智能3 天前
大规模点要素地图渲染性能优化实践
vue.js·arcgis·性能优化·node.js·html·gis·webgl
w3296362716 天前
飞书接单到月度结算:我用一个 DSH 插件跑通鞋类采购 WMS,附 22 项验收
pdf·node.js·飞书·后端开发·ai agent
濮水大叔6 天前
Cabloy/Vona 为什么不需要 NestJS 的 Dynamic Module
typescript·node.js·nestjs
匠云创新6 天前
读完一万段要两分钟:我们把标书读取从 WPS 对象模型搬到了 docx 解析
性能优化·node.js
某哈压力大6 天前
SSH 突然 Connection reset?不是密钥坏了,是 OpenSSL 把 sshd 干趴了
前端·node.js·命令行