json怎么转换成文本格式

轻松：如何将JSON数据转换为文本格式

在当今的软件开发和数据交换领域,JSON（JavaScript Object Notation）已经成为一种轻量级、易于读写的数据交换格式，无论是从API获取数据，还是在不同系统之间传递信息，我们都会频繁地与JSON打交道，在很多场景下，我们需要的不仅仅是机器可读的数据，更需要人类易于理解的纯文本格式，JSON怎么转换成文本格式呢？这其实是一个非常常见的需求，本文将为你详细解析多种实现方法。

理解“转换”的本质：序列化与反序列化

在开始具体操作前,我们先明确一个核心概念，通常我们说的“将JSON转换成文本”，其实包含两种情况：

JSON → 纯文本（序列化）：将一个JSON对象（如JavaScript中的Object或Python中的dict）转换成一个字符串，这个字符串本身就是一种文本格式，可以直接显示、存储或传输，将JavaScript对象{name: "张三", age: 30}转换成字符串'{"name": "张三", "age": 30}'。
JSON → 结构化文本（格式化输出）：将JSON字符串转换成带有缩进和换行的、易读的文本，这通常用于调试、日志记录或向用户展示配置信息，上面的JSON字符串会变成这样：
```
{
  "name": "张三",
  "age": 30
}
```

大多数情况下,我们讨论的是第二种情况，即如何将紧凑的JSON字符串“美化”成可读的文本格式。

在不同编程语言中实现转换

下面我们来看几种主流编程语言中,如何将JSON转换为格式化的文本。

JavaScript / TypeScript

在JavaScript中,这个过程非常直观，我们使用JSON对象的两个核心方法：

JSON.stringify(): 将JavaScript对象或值转换为JSON字符串。
JSON.parse(): 将JSON字符串转换回JavaScript对象。

为了得到格式化的文本,我们只需要在JSON.stringify()中传入额外的参数即可。

// 1. 定义一个JavaScript对象
const userObject = {
  id: 101,
  name: "李四",
  email: "lisi@example.com",
  roles: ["admin", "editor"],
  isActive: true
};
// 2. 使用 JSON.stringify() 进行转换
// 只传一个参数，会得到紧凑的JSON字符串
const compactJson = JSON.stringify(userObject);
console.log("紧凑格式:");
console.log(compactJson);
// 输出: {"id":101,"name":"李四","email":"lisi@example.com","roles":["admin","editor"],"isActive":true}
// 3. 使用第二个参数（空格）进行格式化
// 第二个参数是用于缩进的字符串或数字，这里用2个空格
const prettyJson = JSON.stringify(userObject, null, 2);
console.log("\n格式化文本:");
console.log(prettyJson);

输出结果：

紧凑格式:
{"id":101,"name":"李四","email":"lisi@example.com","roles":["admin","editor"],"isActive":true}
格式化文本:
{
  "id": 101,
  "name": "李四",
  "email": "lisi@example.com",
  "roles": [
    "admin",
    "editor"
  ],
  "isActive": true
}

JSON.stringify(obj, replacer, space)的第三个参数space就是实现格式化的关键，它可以是一个数字（表示缩进空格数，最大为10）或一个字符串（用该字符串作为缩进）。

Python

在Python中,我们通常使用内置的json库来完成这项任务，核心方法是json.dumps()（dump string）和json.loads()（load string）。

import json
# 1. 定义一个Python字典
user_dict = {
    "id": 102,
    "name": "王五",
    "email": "wangwu@example.com",
    "roles": ["user", "viewer"],
    "is_active": False
}
# 2. 使用 json.dumps() 进行转换
# 不加参数，得到紧凑的JSON字符串
compact_json = json.dumps(user_dict)
print("紧凑格式:")
print(compact_json)
# 输出: {"id": 102, "name": "王五", "email": "wangwu@example.com", "roles": ["user", "viewer"], "is_active": false}
# 3. 使用 indent 参数进行格式化
# indent=2 表示使用2个空格进行缩进
pretty_json = json.dumps(user_dict, indent=2, ensure_ascii=False)
print("\n格式化文本:")
print(pretty_json)

输出结果：

紧凑格式:
{"id": 102, "name": "王五", "email": "wangwu@example.com", "roles": ["user", "viewer"], "is_active": false}
格式化文本:
{
  "id": 102,
  "name": "王五",
  "email": "wangwu@example.com",
  "roles": [
    "user",
    "viewer"
  ],
  "is_active": false
}

注意：ensure_ascii=False这个参数很重要，它可以确保非ASCII字符（如中文）能被原样输出，而不是被转义成\u编码。

Java

在Java中,我们可以使用流行的第三方库如 Jackson 或 Gson，这里以Jackson为例，它功能强大且性能优异。

确保你的项目中包含了Jackson的依赖（Maven示例）：

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.2</version>
</dependency>

使用ObjectMapper进行转换：

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Arrays;
import java.util.List;
public class JsonFormatter {
    public static void main(String[] args) {
        // 1. 定义一个Java对象
        User user = new User(103, "赵六", "zhaoliu@example.com", Arrays.asList("guest"), true);
        // 2. 创建 ObjectMapper 实例
        ObjectMapper objectMapper = new ObjectMapper();
        try {
            // 3. 使用 writerWithDefaultPrettyPrinter() 进行格式化
            String prettyJson = objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(user);
            System.out.println("格式化文本:");
            System.out.println(prettyJson);
            // 如果要得到紧凑格式，直接使用 writeValueAsString 即可
            // String compactJson = objectMapper.writeValueAsString(user);
            // System.out.println("\n紧凑格式:");
            // System.out.println(compactJson);
        } catch (JsonProcessingException e) {
            e.printStackTrace();
        }
    }
}
// 一个简单的POJO类
class User {
    public int id;
    public String name;
    public String email;
    public List<String> roles;
    public boolean isActive;
    public User(int id, String name, String email, List<String> roles, boolean isActive) {
        this.id = id;
        this.name = name;
        this.email = email;
        this.roles = roles;
        this.isActive = isActive;
    }
}

输出结果：

格式化文本:
{
  "id" : 103,
  "name" : "赵六",
  "email" : "zhaoliu@example.com",
  "roles" : [ "guest" ],
  "isActive" : true
}

在线工具与命令行方法

如果你不想编写代码,还有一些非常便捷的方法：

在线JSON格式化工具：在搜索引擎中搜索“JSON formatter”或“JSON美化工具”，会找到大量在线网站（如 JSONLint, BEJSON 等），你只需将你的JSON字符串粘贴进去，点击“格式化”或“美化”按钮，即可立即得到格式化的文本，这对于快速检查和调试非常方便。
命令行工具 (如 jq)：对于开发者来说，jq是一个强大的命令行JSON处理器，它像sed一样，可以流式地处理JSON数据。
- 安装jq：根据你的操作系统（macOS, Linux, Windows）进行安装。
- 使用方法：假设你有一个名为data.json的文件，内容是紧凑的JSON。
```
# data.json 内容: {"name":"钱七","city":"北京"}
```
  在终端中运行以下命令：
```
# -C 参数表示带颜色输出，更易读
cat data.json | jq .
```
  输出结果：
```
{
  "name": "钱七",
  "city": "北京"
}
```