如何将任意Rust Debug输出转为JSON等结构化格式

核心思路 #

由于无法修改目标代码，只能基于format!("{foo:?}")的文本输出做转换——核心是用启发式规则解析Debug的固定文本模式，将其转为JSON或其他支持折叠的结构化格式，仅满足人工查看需求，无需保证100%解析稳定性。

具体实现步骤 #

1. 先明确Debug输出的固定模式 #

Rust自动派生的Debug输出有可识别的规律：

• 结构体：StructName { field1: value1, field2: value2 }
• 枚举：EnumName::VariantName(field_val) 或 EnumName::VariantName { key: val }
• 集合类型：数组[v1, v2, v3]、哈希表{k1: v1, k2: v2}、哈希集合HashSet({v1, v2})
• 基础类型：带双引号的字符串"abc"、数字123、布尔值true

2. 启发式解析规则 #

• 层级划分：通过{}、[]、()的嵌套关系识别层级，对应JSON的对象/数组结构
• 键值对提取：结构体、带命名字段的枚举中，用:分割键和值，注意跳过嵌套内容里的:
• 集合转换：把数组格式直接转JSON数组；哈希表格式转JSON对象；哈希集合的({v1,v2})转JSON数组
• 字符串处理：保留原双引号字符串，将无引号的标识符（如枚举变体名）转为JSON字符串
• 格式预处理：先去除{:#?}输出的缩进、换行，转成单行后再解析，减少干扰

3. 快速实现示例（Rust命令行工具） #

可以写一个轻量工具处理Debug输出：

use std::io::{self, Read};

fn main() {
    let mut input = String::new();
    io::stdin().read_to_string(&mut input).unwrap();
    
    // 去除缩进、换行，转成单行
    let single_line = input.replace(['\n', '\t'], "").replace("    ", "");
    
    // 启发式替换为JSON格式
    let mut json = single_line
        .replace("{", "{\"")
        .replace(": ", "\": ")
        .replace(", ", ", \"")
        .replace("::", "\": {\"variant\": \"")
        .replace("HashSet({", "[")
        .replace("})", "]")
        .replace(")", "}");
    
    // 给顶层枚举补外层对象，保证JSON格式合法
    if json.starts_with(|c: char| c.is_alphabetic()) {
        json = format!("{{\"root\": {json}}}");
    }
    
    println!("{}", json);
}

4. 现有工具快速转换方案 #

不想写代码的话，用命令行工具组合处理：

# 假设debug.txt是保存的Debug输出文件
cat debug.txt | tr -d '\n\t' | sed 's/{/{"/g; s/: "/": "/g; s/, /, "/g' | jq .

也可以用VS Code等编辑器的正则替换功能，批量将Debug格式转为JSON，再用编辑器的JSON折叠功能查看层级。

注意事项 #

• 仅针对自动派生的Debug实现有效，自定义Debug格式可能解析失败，但Clippy内部变量基本都是派生实现，完全够用
• 优先用{:#?}生成带缩进的Debug输出，比单行输出更容易做初步层级识别
• 遇到解析错误时手动调整个别格式即可，毕竟只用于人工查看

内容的提问来源于stack exchange，提问作者Yuri Astrakhan