🇺🇸English

Debug Package Usage Guide

Basic Usage

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);

Namespace Conventions

• Desktop: lobe-desktop:[module]
• Server: lobe-server:[module]
• Client: lobe-client:[module]
• Router: lobe-[type]-router:[module]

Format Specifiers

• %O - Object expanded (recommended for complex objects)
• %o - Object
• %s - String
• %d - Number

Enable Debug Output

Browser

localStorage.debug = 'lobe-*';

Node.js

DEBUG=lobe-* npm run dev
DEBUG=lobe-* pnpm dev

Electron

process.env.DEBUG = 'lobe-*';

Example

// src/server/routers/edge/market/index.ts
import debug from 'debug';

const log = debug('lobe-edge-router:market');

log('getAgent input: %O', input);

Weekly Installs

157

Repository

lobehub/lobe-chat

GitHub Stars

74.2K

First Seen

Jan 24, 2026

Security Audits

Gen Agent Trust HubPassSocketPassSnykPass

Installed on

claude-code149

opencode139

gemini-cli133

cursor130

antigravity128

codex126