fastjson格式化

舞夢輝影 2025-10-31 00:00:00 次阅读

使用JSON.toJSONString配合SerializerFeature.PrettyFormat可实现JSON格式化输出，支持缩进和换行，提升可读性；还可组合WriteMapNullValue、WriteDateUseDateFormat等选项控制输出样式，满足多数调试需求。

Fastjson 是阿里巴巴开源的一个高性能的 JSON 库，可以用来将 Java 对象快速转换为 JSON 字符串（序列化），也可以将 JSON 字符串转换为 Java 对象（反序列化）。在开发中，我们经常需要对输出的 JSON 字符串进行格式化，使其具有良好的可读性，比如添加缩进、换行等。

使用 toJSONString 进行格式化输出

fastjson 提供了 JSON.toJSONString() 方法，并配合 SerializerFeature.PrettyFormat 来实现格式化输出。

示例代码：

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.serializer.SerializerFeature;

public class Main {
    public static void main(String[] args) {
        Person person = new Person();
        person.setName("张三");
        person.setAge(25);
        person.setEmail("zhangsan@example.com");

        // 格式化输出 JSON
        String json = JSON.toJSONString(person, SerializerFeature.PrettyFormat);
        System.out.println(json);
    }
}

输出结果会是带缩进、换行的结构化 JSON，例如：

{
	"age":25,
	"email":"zhangsan@example.com",
	"name":"张三"
}

常用格式化选项

除了 PrettyFormat，还可以组合其他格式化特性来控制输出样式：

PrettyFormat：美化输出，自动换行和缩进
WriteMapNullValue：输出 map 中值为 null 的字段
WriteDateUseDateFormat：使用日期格式化输出 Date 类型
DisableCircularReferenceDetect：关闭循环引用检测（谨慎使用）

多个选项可以一起使用：

String json = JSON.toJSONString(obj, 
    SerializerFeature.PrettyFormat,
    SerializerFeature.WriteMapNullValue,
    SerializerFeature.WriteDateUseDateFormat);

自定义格式化风格

如果默认的缩进不够灵活，可以通过 JSONObject.toJSONString() 配合 OutputFilter 或使用第三方工具（如 Jackson 的 PrettyPrinter）进一步定制。但 fastjson 本身不直接支持调整缩进空格数（如 4 空格 vs 2 空格），其 PrettyFormat 固定使用制表符或 4 空格缩进。

若需更精细控制，可考虑将 fastjson 生成的 JSON 字符串交给其他库（如 Gson）进行再格式化，或手动处理字符串换行缩进。