如何输出中文的json

轻松：如何在JSON中正确输出和处理中文**

JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，因其简洁和易读性在软件开发中被广泛应用，在实际应用中，我们经常需要处理包含中文的数据，并将其编码为JSON格式进行输出或传输，由于编码问题，中文在JSON输出时有时会出现乱码，这给数据交互带来了不便，本文将详细介绍如何在各种常见场景下正确输出包含中文的JSON，确保数据的完整性和可读性。

核心问题：编码是关键

JSON标准本身并没有规定字符编码,但推荐使用UTF-8编码，UTF-8作为一种能够表示全球几乎所有字符的编码方式，自然也包括中文，确保JSON数据在生成和传输过程中都使用UTF-8编码，是解决中文输出问题的核心。

常见编程语言/环境中输出中文JSON的方法

不同的编程语言和框架在处理JSON时,其方式略有不同，但核心原则都是一致的：确保字符串使用UTF-8编码。

Python

Python中,可以使用内置的json模块来处理JSON数据。

import json
# 准备包含中文的数据
data = {
    "name": "张三",
    "age": 30,
    "city": "北京",
    "message": "你好，世界！"
}
# 将Python字典转换为JSON格式的字符串
# ensure_ascii=False 是关键，它允许输出非ASCII字符（如中文）
# 如果不设置，中文会被转义为 \uXXXX 的形式
json_str = json.dumps(data, ensure_ascii=False, indent=4)
print(json_str)
# 输出：
# {
#     "name": "张三",
#     "age": 30,
#     "city": "北京",
#     "message": "你好，世界！"
# }
# 如果要写入文件，同样需要指定编码为utf-8
with open("data.json", "w", encoding="utf-8") as f:
    json.dump(data, f, ensure_ascii=False, indent=4)

关键点：

json.dumps()：将Python对象转换为JSON字符串。
json.dump()：将Python对象直接写入文件。
ensure_ascii=False：这是确保中文不被转义为\u编码的关键参数，默认情况下，ensure_ascii=True，中文会被转义。
encoding="utf-8"：在文件操作时，明确指定文件编码为UTF-8。

JavaScript (Node.js & Browser)

在JavaScript中,JSON对象提供了stringify和parse方法。

Node.js环境：

const data = {
    name: "李四",
    age: 25,
    city: "上海",
    message: "JavaScript处理JSON很方便！"
};
// JSON.stringify() 会自动处理非ASCII字符，输出UTF-8编码的JSON字符串
const jsonString = JSON.stringify(data, null, 2); // null表示不进行过滤，2表示缩进2个空格
console.log(jsonString);
// 输出：
// {
//   "name": "李四",
//   "age": 25,
//   "city": "上海",
//   "message": "JavaScript处理JSON很方便！"
// }
// 写入文件（使用Node.js的fs模块）
const fs = require('fs');
fs.writeFileSync('data_node.json', jsonString, 'utf8');

浏览器环境： 浏览器在处理JSON字符串时，通常会根据页面本身的编码（通常是UTF-8）来正确显示中文，使用JSON.stringify()生成的字符串可以直接用于XHR或Fetch API发送，或者在页面上显示。

let data = { "前端中文JSON",
    content: "这是浏览器端输出的中文JSON示例。"
};
let jsonString = JSON.stringify(data);
// 可以直接用于AJAX请求或赋值给DOM元素
console.log(jsonString);

关键点：

JSON.stringify()：JavaScript原生方法，能正确处理中文，默认输出UTF-8编码的字符串。
在Node.js中写入文件时，同样建议指定'utf8'编码。

Java

Java中,可以使用如org.json库或Jackson、Gson等第三方库来处理JSON。

使用 org.json 库：

import org.json.JSONObject;
public class JsonChineseOutput {
    public static void main(String[] args) {
        // 准备数据
        JSONObject data = new JSONObject();
        data.put("name", "王五");
        data.put("age", 28);
        data.put("city", "广州");
        data.put("message", "Java输出中文JSON");
        // 转换为JSON字符串，org.json默认会正确处理中文
        String jsonString = data.toString(2); // 2表示缩进
        System.out.println(jsonString);
        // 输出：
        // {
        //   "name": "王五",
        //   "age": 28,
        //   "city": "广州",
        //   "message": "Java输出中文JSON"
        // }
        // 写入文件
        try {
            java.nio.file.Files.write(java.nio.file.Paths.get("data_java.json"), jsonString.getBytes("UTF-8"));
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

使用 Jackson 库：

import com.fasterxml.jackson.databind.ObjectMapper;
import java.io.File;
import java.io.IOException;
public class JacksonChineseOutput {
    public static void main(String[] args) {
        ObjectMapper objectMapper = new ObjectMapper();
        DataObject data = new DataObject("赵六", 32, "深圳", "Jackson处理中文JSON");
        try {
            // 写入文件，Jackson默认使用UTF-8编码
            objectMapper.writerWithDefaultPrettyPrinter().writeValue(new File("data_jackson.json"), data);
            System.out.println("JSON文件已生成。");
            // 转换为字符串
            String jsonString = objectMapper.writeValueAsString(data);
            System.out.println(jsonString);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}
class DataObject {
    private String name;
    private int age;
    private String city;
    private String message;
    // 构造方法、getters和setters
    public DataObject(String name, int age, String city, String message) {
        this.name = name;
        this.age = age;
        this.city = city;
        this.message = message;
    }
    // 省略其他方法...
}

关键点：

确保使用的JSON库正确处理了UTF-8编码。
在Java中,字符串在内存中是Unicode的，但在写入文件或网络传输时，需要明确指定为UTF-8编码。
Jackson等主流库默认就使用UTF-8。

PHP

PHP中,可以使用json_encode()函数来生成JSON字符串。

<?php
$data = [
    "name" => "陈七",
    "age" => 35,
    "city" => "成都",
    "message" => "PHP输出中文JSON示例"
];
// json_encode() 默认会将中文原样输出（前提是PHP文件编码和HTTP头都是UTF-8）
$jsonString = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
// JSON_UNESCAPED_UNICODE: 确保中文不被转义
// JSON_PRETTY_PRINT: 美化输出，增加缩进
echo $jsonString;
// 输出：
// {
//     "name": "陈七",
//     "age": 35,
//     "city": "成都",
//     "message": "PHP输出中文JSON示例"
// }
// 写入文件
file_put_contents('data_php.json', $jsonString);
?>

关键点：

json_encode()：PHP内置函数。
JSON_UNESCAPED_UNICODE选项：确保中文不被转义为\u形式，这是PHP中处理中文JSON的关键。
确保PHP源文件本身的编码是UTF-8，并且在输出到浏览器时设置正确的HTTP头：header('Content-Type: application/json; charset=utf-8');。

通用注意事项

源文件编码：确保你的源代码文件（如.py, .js, .java, .php）本身是以UTF-8编码保存的，这样字符串字面量中的中文才能被正确读取。
HTTP响应头：如果JSON数据是通过HTTP响应返回的，务必设置正确的Content-Type头： Content-Type: application/json; charset=utf-8 这告诉接收方数据的编码方式是UTF-8。
数据库编码：如果数据来自数据库，确保数据库、表以及相关字段的字符集设置为UTF-8（如MySQL中的utf8mb4，以完整支持包括Emoji在内的所有Unicode字符）。
避免转义：除非有特殊需求（如某些老旧系统不支持非ASCII字符），否则