萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Node.js 開發利器:Supervisor 監聽文件變化自動重啟應用完整指南

痛點與解決

開發調試 Node.js 時,修改代碼需手動 Ctrl+C 停止 → 重啟,極其繁瑣。Supervisor 監聽文件變化自動重啟進程,大幅提升開發效率。

安裝與基本用法

# 全局安裝(推薦,命令行直接用)
npm install supervisor -g

# 或項目局部安裝
npm install supervisor --save-dev
# package.json scripts: "dev": "supervisor app.js"

啟動應用

# 默認監聽當前目錄下所有 .js/.node 文件
supervisor app.js

# 指定入口文件
supervisor ./bin/www

# 監聽 CoffeeScript
supervisor -e 'coffee|js' app.coffee

核心參數詳解

參數短參說明默認值
--watch-w監聽目錄/文件(逗號分隔)當前目錄 .
--ignore-i忽略目錄/文件(不觸發重啟)無
--poll-interval-p輪詢間隔毫秒(文件系統不支持 watch 時)Node 內置
--extensions-e監聽的文件擴展名(管道分隔)node|js
--exec-x執行命令(支持 python, coffee 等)node
--debug啟動 Node 內置調試器 (--inspect)關閉
--quiet-q靜默模式,不輸出 DEBUG 日誌關閉

實戰配置範例

1. 只監聽 src/ 與 config.js,忽略 logs/ public/

supervisor -w src,config.js -i logs,public app.js

2. 運行 TypeScript (ts-node) 並監聽 .ts

supervisor -e 'ts|js' -x ts-node src/main.ts

3. 啟用調試模式(配合 VS Code/Chrone DevTools)

supervisor --debug app.js
# 或 Node 8+ 建議
supervisor --inspect=0.0.0.0:9229 app.js

4. package.json scripts 整合

{
  "scripts": {
    "dev": "supervisor -w src,config -i logs,node_modules -q app.js",
    "debug": "supervisor --inspect -w src,config -i logs,node_modules app.js",
    "start": "node app.js"
  }
}

同類工具對比

工具特點適用場景
Supervisor極簡、零配置、穩定、支持非 JS 腳本通用 Node 開發首選
Nodemon功能豐富、配置文件、支持 --delay、--legacy-watch需精細控制重啟行為、大項目
PM2 (dev 模式)生產級進程管理、集群、日誌、監控、pm2 start app.js --watch開發/生產一體化、需要零停機部署
Run.js極簡、類 Supervisor、功能較弱極簡項目

原理補充

  • Supervisor 使用 fs.watch (事件驅動) 或 fs.watchFile (輪詢) 監聽文件 mtime 變化
  • 檢測到變化 → SIGTERM 結束子進程 → 重新 spawn 新進程
  • 不支持熱模塊替換 (HMR),只能整進程重啟(較慢但穩定)
  • 需 HMR 請用 webpack-dev-server (前端) 或 ts-node-dev (TS 後端)

最佳實踐建議

  1. 項目根目錄建立 nodemon.json 或 supervisor.json 統一配置,避免命令行過長
  2. --ignore node_modules,logs,public,dist 排除無關目錄,減少誤觸發
  3. 配合 --quiet 減少噪音,關鍵錯誤仍會顯示
  4. 生產環境**絕不**用 Supervisor/Nodemon,改用 PM2 / systemd / Docker + 健康檢查
copyright © 萬盛學電腦網 all rights reserved