debug について
LobeHub プロジェクトで debug パッケージを使うためのガイドです。モジュール別の名前空間、ログ書式、ブラウザー、Node.js、Electron での出力有効化方法を説明します。
主な機能
- 01モジュール別の名前空間規則
- 02オブジェクトや数値の書式指定子
- 03ブラウザーでの出力有効化
- 04Node.js の環境変数によるログ有効化
- 05Electron の設定例
活用シーン
- 01サーバーやクライアント別のログ絞り込み
- 02デバッグ時のログオブジェクト確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ lobehub/ lobehub --skill debugインストール後、Claude Code で/debugを入力して読み込まれたか確認します。
詳細
Debug パッケージの使用ガイド
基本的な使い方
import debug from 'debug';
// Format: lobe-[module]:[submodule]
const log = debug('lobe-server:market');
log('Simple message');
log('With variable: %O', object);
log('Formatted number: %d', number);
名前空間の規則
- デスクトップ:
lobe-desktop:[module] - サーバー:
lobe-server:[module] - クライアント:
lobe-client:[module] - ルーター:
lobe-[type]-router:[module]
書式指定子
%O- 展開されたオブジェクト(複雑なオブジェクトに推奨)%o- オブジェクト%s- 文字列%d- 数値
デバッグ出力を有効にする
ブラウザー
localStorage.debug = 'lobe-*';
Node.js
DEBUG=lobe-* npm run dev
DEBUG=lobe-* pnpm dev
Electron
process.env.DEBUG = 'lobe-*';
例
// src/server/routers/edge/market/index.ts
import debug from 'debug';
const log = debug('lobe-edge-router:market');
log('getAgent input: %O', input);
コメント
Markdown 対応