如何把json字符串格式化

如何优雅地将JSON字符串格式化：从混乱到有序的完整指南

在开发过程中，JSON（JavaScript Object Notation）作为轻量级的数据交换格式，几乎无处不在，但你是否遇到过这样的场景：从接口返回的JSON字符串是一行无空格的“压缩”文本（如 {"name":"张三","age":25,"hobbies":["阅读","游泳"],"address":{"city":"北京","district":"朝阳区"}}），手动阅读和调试时如同“天书”？或者需要将JSON数据粘贴到文档中，却因格式混乱影响可读性？这时，JSON字符串格式化就成了必备技能，本文将带你从基础到进阶，全面JSON格式化的方法,让你轻松应对各种场景。

为什么需要格式化JSON字符串？

JSON格式化的核心目的是提升可读性，未格式化的JSON字符串（也称“minified”或“压缩”JSON）虽然节省存储空间，但对人类阅读极不友好：字段和值紧密粘连，嵌套结构难以分辨，调试时容易看错括号或逗号，而格式化后的JSON会通过缩进和换行将数据结构清晰呈现，

{
  "name": "张三",
  "age": 25,
  "hobbies": [
    "阅读",
    "游泳"
  ],
  "address": {
    "city": "北京",
    "district": "朝阳区"
  }
}

这种格式不仅能让你快速定位数据字段，还能在调试时直观发现语法错误（如缺少逗号、括号不匹配等），格式化后的JSON也更适合展示在文档、报告或用户界面中,提升用户体验。

JSON格式化的核心原则

在动手格式化前，需要明确JSON格式化的基本原则,避免操作后生成无效的JSON：

保持语法正确性

JSON的语法规则必须严格遵守,包括：

• 键名必须用双引号（）包围，不能用单引号（）；
• 值只能是字符串、数字、布尔值（true/false）、null、数组或对象,不能是函数或undefined；
• 数组和对象中的最后一个元素后不能有逗号（如 {"name":"张三",} 是错误的）。

合理使用缩进和换行

• 缩进通常使用2个空格或4个空格（根据团队规范选择，推荐2空格更节省空间）；
• 每个键值对、数组元素、嵌套结构换行显示,避免单行过长；
• 数组元素和对象成员对齐,提升视觉层次感。

处理特殊字符

JSON字符串中的特殊字符（如换行符\n、引号\"、反斜杠\\等）需要正确转义，否则会导致解析错误，格式化工具通常会自动处理这些转义,但手动编辑时需注意。

常见场景下的JSON格式化方法

场景1：在线格式化工具（适合快速处理）

如果你只是偶尔需要格式化JSON，或者不想安装额外工具，在线格式化器是最便捷的选择,推荐以下工具：

（1）JSON Formatter & Validator（https://jsonformatter.curiousconcept.com/）

• 特点：支持实时格式化、语法高亮、错误提示,可自定义缩进空格数；
• 使用方法：粘贴未格式化的JSON到输入框，右侧自动显示格式化结果，点击“Copy”即可复制。

（2）Beautify JSON（https://jsonbeautifier.org/）

• 特点：界面简洁，支持JSON压缩（反向操作）、JSON Schema验证；
• 使用方法：输入JSON后，点击“Beautify”按钮,即可生成格式化结果。

（3）Code Beautify（https://codebeautify.org/jsonformatter）

• 特点：支持多种编程语言的代码格式化，JSON只是其中之一,功能更全面；
• 使用方法：选择“JSON Formatter”工具，粘贴JSON后点击“Format JSON”。

适用场景：临时处理少量JSON数据，无需安装软件,适合开发者或非技术人员快速使用。

场景2：编程语言实现（适合自动化处理）

在开发中，经常需要在代码中动态格式化JSON（如调试时打印结构化数据）,主流编程语言都提供了内置库或第三方库支持JSON格式化。

（1）JavaScript/Node.js

JavaScript的JSON对象自带stringify方法，可通过space参数控制缩进：

const unformattedJson = '{"name":"张三","age":25,"hobbies":["阅读","游泳"],"address":{"city":"北京","district":"朝阳区"}}';
// 格式化JSON（缩进2个空格）
const formattedJson = JSON.stringify(JSON.parse(unformattedJson), null, 2);
console.log(formattedJson);
// 输出结果：
// {
//   "name": "张三",
//   "age": 25,
//   "hobbies": [
//     "阅读",
//     "游泳"
//   ],
//   "address": {
//     "city": "北京",
//     "district": "朝阳区"
//   }
// }

说明：

• JSON.parse(unformattedJson)：将字符串解析为JavaScript对象（确保输入是合法JSON）；
• JSON.stringify(obj, null, space)：space参数为数字时，表示缩进的空格数（如2或4）；为字符串时（如"\t"）,表示用制表符缩进。

（2）Python

Python的json模块提供了dumps方法，通过indent参数控制缩进：

import json
unformatted_json = '{"name":"张三","age":25,"hobbies":["阅读","游泳"],"address":{"city":"北京","district":"朝阳区"}}'
# 格式化JSON（缩进4个空格）
formatted_json = json.dumps(json.loads(unformatted_json), indent=4, ensure_ascii=False)
print(formatted_json)
# 输出结果：
# {
#     "name": "张三",
#     "age": 25,
#     "hobbies": [
#         "阅读",
#         "游泳"
#     ],
#     "address": {
#         "city": "北京",
#         "district": "朝阳区"
#     }
# }

说明：

• json.loads(unformatted_json)：将JSON字符串解析为Python字典；
• json.dumps(obj, indent, ensure_ascii)：indent参数控制缩进（默认None即不格式化）；ensure_ascii=False确保非ASCII字符（如中文）正常显示,而非转义为Unicode。

（3）Java

Java可以使用Gson或Jackson库格式化JSON（以Gson为例）：

import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
public class JsonFormatter {
    public static void main(String[] args) {
        String unformattedJson = "{\"name\":\"张三\",\"age\":25,\"hobbies\":[\"阅读\",\"游泳\"],\"address\":{\"city\":\"北京\",\"district\":\"朝阳区\"}}";
        // 创建Gson实例，设置缩进为2
        Gson gson = new GsonBuilder().setPrettyPrinting().create();
        // 解析并格式化JSON
        Object jsonObject = gson.fromJson(unformattedJson, Object.class);
        String formattedJson = gson.toJson(jsonObject);
        System.out.println(formattedJson);
    }
}

输出结果：

{
  "name": "张三",
  "age": 25,
  "hobbies": [
    "阅读",
    "游泳"
  ],
  "address": {
    "city": "北京",
    "district": "朝阳区"
  }
}

说明：GsonBuilder().setPrettyPrinting()启用美化打印，toJson方法会自动处理缩进。

（4）C

C#可以使用Newtonsoft.Json（Json.NET）库格式化JSON：

using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
class Program
{
    static void Main()
    {
        string unformattedJson = "{\"name\":\"张三\",\"age\":25,\"hobbies\":[\"阅读\",\"游泳\"],\"address\":{\"city\":\"北京\",\"district\":\"朝阳区\"}}";
        // 解析JSON
        JObject jsonObject = JObject.Parse(unformattedJson);
        // 格式化JSON（缩进2个空格）
        string formattedJson = jsonObject.ToString(Formatting.Indented);
        Console.WriteLine(formattedJson);
    }
}

输出结果：

{
  "name": "张三",
  "age": 25,
  "hobbies": [
    "阅读",
    "游泳"
  ],
  "address": {
    "city": "北京",
    "district": "朝阳区"
  }
}

说明：Formatting.Indented指定缩进格式，ToString方法生成格式化后的JSON字符串。

适用场景：需要在代码中动态格式化JSON，如调试日志、API响应处理、数据导出等。