nodemon命令介绍（Node.js代码监视并自动重启工具、代码监控代码、监控文件监控）重启node重启（注意：Node.js v22引入了稳定内置监视模式，提供更集成、更高效文件监控机制）

Nodemon：高效开发利器

1. Nodemon 简介

Nodemon 是一个强大的 Node.js 开发工具，专为解决开发过程中频繁重启应用的痛点而设计。它能够自动监测项目文件变化，并立即重启应用，让开发者专注于代码编写而非重复性操作。

1.1 核心功能

- 实时监控：自动监测文件变化并重启 Node.js 应用

- 零侵入性：无需修改现有代码，完全替代 node 命令

- 高度可配置：支持自定义监控目录、文件类型和忽略项

- 跨平台兼容：适用于所有主流操作系统

1.2 为什么需要 Nodemon

在传统开发流程中，每次修改代码后都需要手动停止并重启应用，这大大降低了开发效率。Nodemon 通过自动化这一流程，不仅节省了大量时间，还保持了开发过程的连贯性，让开发者能够专注于创造性工作。

2. 安装与基本使用

2.1 安装方式

Nodemon 提供了多种安装方式，适应不同的项目需求：

# 全局安装
npm install -g nodemon

# 项目本地安装
npm install --save-dev nodemon

安装完成后，可通过以下命令检查版本，确认安装成功：

nodemon --version

2.2 基本用法

Nodemon 的使用非常简单，只需将原来的 node 命令替换为 nodemon：

# 替代 node app.js
nodemon app.js

# 带参数启动
nodemon app.js 3000

示例应用：

// app.js
const express = require("express");
const app = express();

// 定义简单路由
app.get("/", (req, res) => {
  res.send("Hello, Nodemon!");
});

// 启动服务器
const port = process.env.PORT || 3000;
app.listen(port, () => {
  console.log(`服务器已在端口 ${port} 启动`);
});

启动后，Nodemon 会显示如下信息：

[nodemon] 3.1.10
[nodemon] 随时输入 'rs' 重启应用
[nodemon] 监视路径: *.*
[nodemon] 监视扩展名: js,mjs,json
[nodemon] 正在启动 `node app.js`
服务器已在端口 3000 启动

3. 高级配置与优化

3.1 命令行选项

Nodemon 提供了丰富的命令行选项，满足复杂场景需求：

• --exec：指定执行文件的程序，例如 ts-node
• --ext：指定监控的文件扩展名，如 --ext js,ts,json
• --delay：设置检测到变化后延迟重启的时间
• --watch：指定要监控的目录
• --ignore：指定要忽略的文件或目录
• --verbose：启用详细输出模式

示例复杂配置：

nodemon --watch src --ext ts --exec ts-node --ignore '*.test.ts' --delay 2.5 src/server.ts

3.2 配置文件

对于复杂项目，推荐使用配置文件管理 Nodemon 设置。可创建 nodemon.json 文件：

{
  "watch": ["src"],
  "ext": "ts",
  "ignore": ["src/**/*.test.ts"],
  "delay": 2500,
  "execMap": {
    "ts": "ts-node"
  }
}

或在 package.json 中添加配置：

{
  "name": "my-app",
  "version": "1.0.0",
  "nodemonConfig": {
    "watch": ["src"],
    "ext": "ts",
    "ignore": ["src/**/*.test.ts"],
    "delay": 2500,
    "execMap": {
      "ts": "ts-node"
    }
  }
}

3.3 优化监控效率

为提高监控效率，可采取以下策略：

1. 限定监控范围：只监控关键目录，减少不必要的文件监控

{
  "watch": ["src", "config"]
}

2. 排除不相关文件：忽略不会影响应用运行的文件

{
  "ignore": ["node_modules", "logs", "public", "**/*.test.js"]
}

3. 设置合理延迟：避免频繁文件修改导致的过度重启

{
  "delay": 1000
}

4. 在特殊环境中使用 Nodemon

4.1 Docker 容器中使用

在 Docker 开发环境中集成 Nodemon 可显著提高开发效率：

Dockerfile 配置：

FROM node:14

WORKDIR /app

COPY package*.json ./
RUN npm install

# 全局安装 nodemon
RUN npm install -g nodemon

COPY . .

EXPOSE 3000

CMD ["nodemon", "app.js"]

docker-compose.yml 配置：

version: "3"
services:
  app:
    build: .
    volumes:
      - .:/app
      - /app/node_modules
    ports:
      - "3000:3000"
    command: nodemon app.js

此配置通过卷挂载实现主机文件变更自动同步到容器，并由 Nodemon 负责重启应用。

4.2 内存泄漏处理

长时间运行的 Nodemon 进程可能面临内存泄漏问题，可采取以下措施：

1. 监控内存使用：

setInterval(() => {
  const memoryUsage = process.memoryUsage();
  console.log(`内存使用：RSS ${memoryUsage.rss / 1024 / 1024} MB`);
}, 10000);

2. 优化监控配置：减少监控范围以降低内存消耗

{
  "watch": ["src"],
  "ignore": ["logs/*", "public/*", "node_modules/*"]
}

3. 设置延迟重启：给系统留出资源清理时间

nodemon --delay 2 app.js

4. 定期重启：对于长期开发会话，可使用 PM2 设置自动重启策略

pm2 start nodemon --name "app" -- app.js --max-memory-restart 200M

5. 最佳实践与常见问题解决

5.1 最佳实践

1. 使用 NPM 脚本集成：在 package.json 中配置启动命令

{
  "scripts": {
    "dev": "nodemon src/index.js",
    "dev:ts": "nodemon --exec ts-node src/index.ts"
  }
}

2. 利用事件触发外部操作：通过 nodemon.json 配置

{
  "events": {
    "restart": "clear && echo '应用已重启'"
  }
}

3. 组合使用其他工具：与 TypeScript、ESLint 等工具结合使用

{
  "exec": "ts-node src/index.ts && eslint src/"
}

5.2 常见问题解决

1. 文件变更不触发重启：

• 检查监控配置是否正确
• 确认文件扩展名是否包含在监控列表中
• 排查是否被 ignore 规则排除

2. Windows 系统兼容性问题：

• 对于文件系统监控问题，使用 --legacy-watch 选项
• 权限问题可尝试以管理员身份运行

3. 与其他工具冲突：

• 避免多个监控工具同时运行
• 确保端口不被其他服务占用

6. 高级用例与集成

6.1 与 TypeScript 集成

对于 TypeScript 项目，Nodemon 可与 ts-node 结合使用：

{
  "scripts": {
    "dev": "nodemon --exec ts-node src/index.ts"
  },
  "nodemonConfig": {
    "watch": ["src"],
    "ext": "ts",
    "execMap": {
      "ts": "ts-node"
    }
  }
}

6.2 与 Webpack 集成

对于使用 Webpack 的项目，可结合 Nodemon 监控服务端代码：

// webpack.config.js
const nodeExternals = require('webpack-node-externals');

module.exports = {
  target: 'node',
  externals: [nodeExternals()],
  // 其他配置...
};

// package.json
{
  "scripts": {
    "build": "webpack --config webpack.config.js",
    "dev": "nodemon --watch dist dist/server.js"
  }
}

6.3 与 Node.js 调试工具集成

Nodemon 可与 Node.js 调试工具无缝集成：

{
  "scripts": {
    "debug": "nodemon --inspect src/index.js"
  }
}

这样配置后，可在浏览器开发工具或 VS Code 中连接调试器，且在代码变更后自动重启并保持调试连接。

7. 总结与展望

Nodemon 作为 Node.js 开发的核心工具，极大地提升了开发效率和体验。它简单易用却功能强大，适应各种开发场景和需求。

随着 Node.js 生态的不断发展，Nodemon 也在持续完善和更新。值得注意的是，Node.js v22 已经引入了稳定的内置监视模式，提供了更集成、更高效的文件监控机制，为开发者提供了更多选择。

无论选择哪种工具，自动化开发流程都是提升效率的关键。掌握 Nodemon 这一利器，将帮助开发者构建更高效、更愉悦的 Node.js 开发体验。

示例代码：RESTful API 服务器

// server.js
const express = require('express');
const morgan = require('morgan');

// 初始化应用
const app = express();
const port = process.env.PORT || 3000;

// 中间件配置
app.use(express.json());
app.use(morgan('dev')); // 日志中间件

// 模拟数据库
const items = [
  { id: 1, name: '项目1', completed: false },
  { id: 2, name: '项目2', completed: true }
];

// 路由定义
// 获取所有项目
app.get('/api/items', (req, res) => {
  res.json(items);
});

// 获取单个项目
app.get('/api/items/:id', (req, res) => {
  const id = parseInt(req.params.id);
  const item = items.find(item => item.id === id);
  
  if (!item) {
    return res.status(404).json({ message: '项目不存在' });
  }
  
  res.json(item);
});

// 创建新项目
app.post('/api/items', (req, res) => {
  const { name } = req.body;
  
  if (!name) {
    return res.status(400).json({ message: '名称不能为空' });
  }
  
  const newItem = {
    id: items.length + 1,
    name,
    completed: false
  };
  
  items.push(newItem);
  res.status(201).json(newItem);
});

// 更新项目
app.put('/api/items/:id', (req, res) => {
  const id = parseInt(req.params.id);
  const itemIndex = items.findIndex(item => item.id === id);
  
  if (itemIndex === -1) {
    return res.status(404).json({ message: '项目不存在' });
  }
  
  const updatedItem = {
    ...items[itemIndex],
    ...req.body
  };
  
  items[itemIndex] = updatedItem;
  res.json(updatedItem);
});

// 删除项目
app.delete('/api/items/:id', (req, res) => {
  const id = parseInt(req.params.id);
  const itemIndex = items.findIndex(item => item.id === id);
  
  if (itemIndex === -1) {
    return res.status(404).json({ message: '项目不存在' });
  }
  
  items.splice(itemIndex, 1);
  res.status(204).end();
});

// 启动服务器
app.listen(port, () => {
  console.log(`服务器已在端口 ${port} 启动`);
  console.log(`使用 Nodemon 监控中，修改代码将自动重启`);
});