痛點與解決
開發調試 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 後端)
最佳實踐建議
- 項目根目錄建立
nodemon.json 或 supervisor.json 統一配置,避免命令行過長
--ignore node_modules,logs,public,dist 排除無關目錄,減少誤觸發
- 配合
--quiet 減少噪音,關鍵錯誤仍會顯示
- 生產環境**絕不**用 Supervisor/Nodemon,改用 PM2 / systemd / Docker + 健康檢查