关于 debug-package
介绍 `debug` 包的使用方式,涵盖日志命名空间、格式说明符,以及在浏览器、Node.js 和 Electron 中启用调试输出的方法。
主要功能
- 01按应用区域划分命名空间
- 02对象、字符串和数字格式说明符
- 03启用浏览器调试输出
- 04启用 Node.js 和 Electron 调试输出
适用场景
- 01为服务端代码添加命名日志
- 02在调试输出中检查对象值
- 03开发时启用浏览器日志
- 04在 Node.js 或 Electron 中开启调试
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ lobehub/ lobehub --skill debug-package安装后在 Claude Code 中输入/debug-package确认已加载。
详细介绍
调试包使用指南
基本用法
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-* bun run dev
DEBUG=lobe-* pnpm dev
Electron
process.env.DEBUG = 'lobe-*';
示例
// apps/server/src/routers/lambda/agentEval.ts
import debug from 'debug';
const log = debug('lobe-lambda-router:agent-eval');
log('getAgent input: %O', input);
评论
支持 Markdown