debug 是做什麼的？
Debug 套件使用指南。適用於新增偵錯日誌、理解日誌命名空間或實作除錯功能。由偵錯日誌請求或日誌實作觸發。
簡介
debug 是一個輕量級的 Node.js 與瀏覽器偵錯工具，透過命名空間機制讓你輕鬆控制哪些日誌應該輸出。它模仿了 Node.js 核心的除錯方式，常用於 libraries 與應用程式中以提供可開關的內部除錯資訊。
安裝
npm install debug
基本用法
在你的模組中引入 debug 並建立一個除錯器實例：
const debug = require('debug')('myapp:server');
debug('伺服器啟動中...');
命名空間
命名空間以冒號 (:) 分隔層級。例如：
myapp:servermyapp:server:dbmyapp:client
啟用除錯日誌
透過 DEBUG 環境變數控制：
# 啟用 myapp 命名空間下所有日誌
DEBUG=myapp:* node app.js
# 啟用多個命名空間
DEBUG=myapp:server,express:* node app.js
# 啟用所有日誌（不建議生產環境使用）
DEBUG=* node app.js
進階功能
顏色輸出
每個命名空間會自動分配顏色以區分輸出。
動態啟用
你也可以在執行時動態啟用：
debug.enable('myapp:*');
瀏覽器相容性
在瀏覽器環境中，debug 會使用 localStorage 儲存啟用設定：
localStorage.debug = 'myapp:*';
與開發環境整合
此技能針對 Cursor、Claude Code 與其他支援 Markdown 技能定義的開發環境進行了最佳化。當你提出關於偵錯日誌或除錯功能的請求時，此技能將自動觸發並提供相關指引。