调试控制台美化(Debug Console Beautify)
美化 VSCode 调试控制台输出,支持 JSON 格式化、日志分级高亮、分割线、分块合并等高级特性,极大提升调试体验。
🆕 v0.0.7 新特性
- ⚡ 真正立即生效: 启用/禁用在当前调试会话中立即生效,零延迟体验
- 🔄 智能热重载: 配置变化时自动应用,无需手动重载
- 🎯 会话管理: 自动检测调试会话状态,提供一键重载选项
- 💨 零性能开销: 禁用时不执行任何逻辑,真正的零开销
- 🎨 智能反馈: 根据调试会话状态提供精确的用户反馈
主要特性
- 支持多种日志级别高亮
- 智能 JSON 格式化与分块合并
- 可自定义规则、颜色、样式
- 支持分割线、主题自适应
- 一键启用/禁用(无需重载窗口)
- 丰富的诊断与测试命令
- 兼容 VSCode 与主流魔改版
调试日志
- 如果遇到问题,可以通过"显示调试控制台美化日志"查看详细的状态跟踪
- 日志会显示配置更新、tracker状态、性能统计等详细信息
安装与使用
安装
- 在 VSCode 扩展市场搜索
调试控制台美化 或 Debug Console Beautify 并安装
- 或下载
.vsix 文件后,使用命令面板"扩展:从 VSIX 安装..."进行安装
启用/禁用
- 通过命令面板(Cmd+Shift+P)输入
启用调试控制台美化 或 禁用调试控制台美化
- 或在设置中搜索
debugConsoleBeautify.enabled
配置说明
配置项 |
说明 |
默认值 |
enabled |
是否启用插件 |
true |
formatJSON |
是否自动格式化 JSON |
true |
showLogSeparator |
是否显示分割线 |
true |
outputBufferTimeoutMs |
分块合并超时时间(ms) |
200 |
maxJsonSizeKB |
最大 JSON 格式化大小(KB) |
1024 |
safeJsonSizeKB |
安全 JSON 格式化大小(KB) |
32 |
rules |
日志高亮规则 |
见下文 |
规则示例
"rules": [
{
"pattern": "error|ERROR|Error",
"color": { "dark": "#FF5555", "light": "#CC0000" },
"bold": true
},
{
"pattern": "info|INFO|Info",
"color": { "dark": "#6BB6FF", "light": "#0066CC" }
}
]
命令列表
- Debug Console Beautify: 启用调试控制台美化
- Debug Console Beautify: 禁用调试控制台美化
- Debug Console Beautify: 显示调试控制台美化日志
效果对比
开启前(默认):

开启后(开启 JSON 格式化、分割线):

开发与贡献
- 克隆本仓库: https://github.com/vikiea/debug-console-beautify
npm install
- 按需修改代码,建议遵循
src/ 目录的模块化结构
npm run compile 或直接在 VSCode 调试
- 欢迎 PR 和 issue!
更新日志
v0.0.7
- 🚀 优化启用/禁用逻辑,无需重新加载窗口
- 🔄 添加智能热重载支持和会话管理
- 🎯 简化架构,移除复杂的tracker管理逻辑
- ⚡ 性能优化,禁用时零开销
v0.0.6
常见问题
- JSON 格式化失败?请检查 JSON 是否过大或格式有误。
- 新: 配置变化不生效?v0.0.7已优化,配置变化会立即生效。
License
MIT
| |