使用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）进行再格式化，或手动处理字符串换行缩进。
基本上就这些。使用 toJSONString + PrettyFormat 已能满足大多数调试和日志场景下的格式化需求。
