object怎么转成json

从 Object 到 JSON：全面解析数据序列化方法与最佳实践

在软件开发中,JSON（JavaScript Object Notation）因其轻量级、易读易写的特性，已成为前后端数据交换、配置文件存储、API 通信等场景的主流格式，而将编程语言中的对象（Object）转换为 JSON 字符串，即“序列化”（Serialization），是日常开发中高频操作，本文将以主流编程语言为例，详细解析 Object 转 JSON 的方法、注意事项及最佳实践。

什么是 Object 转 JSON？

“Object 转 JSON” 指的是将内存中的对象数据（如 Python 的字典、Java 的实体类、JavaScript 的对象等）按照 JSON 规范转换为字符串的过程，JSON 规范要求数据必须是键值对形式（键必须是字符串，值可以是字符串、数字、布尔值、数组、null 或嵌套的 JSON 对象），因此序列化的核心是将不同语言的 Object 结构映射为符合 JSON 规范的字符串。

主流语言中的 Object 转 JSON 方法

不同编程语言提供了内置库或第三方工具实现 Object 转 JSON，以下是常见语言的实践示例：

JavaScript/TypeScript：原生 JSON.stringify() 与自定义处理

JavaScript 中，JSON.stringify() 是将对象转为 JSON 字符串的内置方法，语法简单，但需注意其特性：

const obj = {
  name: "Alice",
  age: 25,
  hobbies: ["reading", "coding"],
  isStudent: true,
  address: null
};
// 基本序列化
const jsonString = JSON.stringify(obj);
console.log(jsonString); 
// 输出: {"name":"Alice","age":25,"hobbies":["reading","coding"],"isStudent":true,"address":null}
// 自定义序列化（过滤或转换值）
const filteredJson = JSON.stringify(obj, (key, value) => {
  if (key === "age") return undefined; // 过滤 age 字段
  if (typeof value === "string") return value.toUpperCase(); // 字符串转大写
  return value;
});
console.log(filteredJson); 
// 输出: {"name":"ALICE","hobbies":["READING","CODING"],"isStudent":true,"address":null}
// 格式化输出（美化）
const prettyJson = JSON.stringify(obj, null, 2);
console.log(prettyJson); 
// 输出格式化后的 JSON，缩进 2 个空格

注意事项：

• JSON.stringify() 会忽略对象的函数、Symbol 类型值和 undefined。
• 循环引用的对象会导致序列化报错（需通过 replacer 函数处理或使用第三方库如 flatted）。

Python：json 模块与 defaultdict、datetime 等特殊类型处理

Python 通过内置 json 模块实现序列化，核心方法是 json.dumps()（ dumps = dump string）：

import json
from datetime import datetime
obj = {
    "name": "Bob",
    "age": 30,
    "hobbies": ["music", "travel"],
    "metadata": {"score": 95.5, "is_active": True}
}
# 基本序列化
json_str = json.dumps(obj)
print(json_str)  
# 输出: {"name": "Bob", "age": 30, "hobbies": ["music", "travel"], "metadata": {"score": 95.5, "is_active": true}}
# 格式化输出（缩进 4 个空格）
pretty_json = json.dumps(obj, indent=4, ensure_ascii=False)
print(pretty_json)  # 支持非 ASCII 字符（如中文）
# 处理特殊类型（如 datetime）
def datetime_handler(obj):
    if isinstance(obj, datetime):
        return obj.isoformat()
    raise TypeError(f"Object of type {type(obj)} is not JSON serializable")
obj_with_datetime = {"time": datetime.now()}
json_str_with_time = json.dumps(obj_with_datetime, default=datetime_handler)
print(json_str_with_time)  
# 输出: {"time": "2023-10-01T12:00:00.000000"}

注意事项：

• Python 的 datetime、set、complex 等类型无法直接序列化，需通过 default 参数自定义处理逻辑。
• ensure_ascii=False 可确保中文字符不被转义为 Unicode（如 \u4e2d\u56fd）。

Java：Jackson/Gson 库与注解控制

Java 中没有内置的 JSON 序列化支持，需依赖第三方库，主流选择有 Jackson、Gson 等，以 Jackson 为例：

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Arrays;
import java.util.Date;
public class ObjectToJson {
    public static void main(String[] args) {
        User user = new User("Charlie", 28, Arrays.asList("swimming", "games"));
        user.setMetadata(new Metadata(88.0, true));
        ObjectMapper mapper = new ObjectMapper();
        try {
            // 基本序列化
            String jsonStr = mapper.writeValueAsString(user);
            System.out.println(jsonStr); 
            // 输出: {"name":"Charlie","age":28,"hobbies":["swimming","games"],"metadata":{"score":88.0,"is_active":true}}
            // 格式化输出
            String prettyJson = mapper.writerWithDefaultPrettyPrinter().writeValueAsString(user);
            System.out.println(prettyJson); // 缩进美化
        } catch (JsonProcessingException e) {
            e.printStackTrace();
        }
    }
}
// 实体类
class User {
    private String name;
    private int age;
    private String[] hobbies;
    private Metadata metadata;
    // getters/setters 省略
    // @JsonIgnore 可忽略字段
    // @JsonProperty("new_name") 可重命名字段
}
class Metadata {
    private double score;
    private boolean isActive;
    // getters/setters 省略
}

注意事项：

• 需添加依赖（如 Jackson 的 jackson-databind）。
• 通过注解（如 @JsonIgnore、@JsonProperty）灵活控制字段序列化行为。

C#：System.Text.Json 与 Newtonsoft.Json

C# 中，推荐使用 System.Text.Json（.NET Core 3.0+ 内置）或第三方库 Newtonsoft.Json：

using System;
using System.Text.Json;
using System.Collections.Generic;
public class ObjectToJsonExample
{
    public static void Main()
    {
        var obj = new
        {
            Name = "David",
            Age = 35,
            Hobbies = new List<string> { "football", "cooking" },
            Metadata = new { Score = 92.5, IsActive = true }
        };
        // 使用 System.Text.Json
        string jsonStr = JsonSerializer.Serialize(obj);
        Console.WriteLine(jsonStr); 
        // 输出: {"Name":"David","Age":35,"Hobbies":["football","cooking"],"Metadata":{"Score":92.5,"IsActive":true}}
        // 格式化输出
        var options = new JsonSerializerOptions { WriteIndented = true };
        string prettyJson = JsonSerializer.Serialize(obj, options);
        Console.WriteLine(prettyJson);
    }
}

注意事项：

• System.Text.Json 性能优于 Newtonsoft.Json，后者功能更丰富（如 LINQ to JSON）。
• 可通过 JsonSerializerOptions 配置序列化行为（如忽略 null 值、驼峰命名等）。

Object 转 JSON 的常见问题与解决方案

1. 循环引用问题
   当对象中存在直接或间接的自引用时（如 A 对象包含 B 对象，B 对象又引用 A 对象），序列化会陷入无限递归，导致栈溢出。
   解决方案：

   • JavaScript：使用 flatted 或 lodash.cloneDeep 预处理对象。
   • Python：通过 default 函数检测循环引用并抛出异常或替换为标识符。
   • Java：Jackson 使用 @JsonIdentityInfo 注解标识循环引用字段。

2. 特殊类型处理（如日期、自定义对象）
   不同语言对日期、枚举、自定义类的处理方式不同，直接序列化可能报错或输出非预期格式。
   解决方案：

   • 统一将日期转换为 ISO 8601 字符串（如 yyyy-MM-ddTHH:mm:ss）。
   • 自定义序列化逻辑（如实现 Serializable 接口或编写 Converter）。

3. 字段过滤与重命名
   实际开发中可能需要忽略敏感字段（如密码）或统一字段命名风格（如驼峰转下划线）。
   解决方案：

   • JavaScript：JSON.stringify() 的 replacer 参数。
   • Python：json.dumps() 的 default 参数或 dataclasses 库的 field 配