object如何转成json串

将Object转换为JSON串的全面指南

在软件开发中,JSON（JavaScript Object Notation）因其轻量级、易读、跨语言兼容等特性，已成为数据交换的主流格式，无论是前端向后端传递数据，还是后端服务间的通信，经常需要将编程语言中的对象（Object）转换为JSON串，本文将以主流语言（如JavaScript、Python、Java）为例，系统介绍Object转JSON串的方法、注意事项及最佳实践。

什么是JSON串？为什么需要转换？

JSON串是一种文本格式,采用键值对（key-value pair）的结构组织数据，类似于JavaScript中的对象字面量，但格式更严格（属性名必须用双引号包裹，不支持注释），常见的JSON串示例：

{
  "name": "张三",
  "age": 25,
  "isStudent": false,
  "courses": ["数学", "英语"],
  "address": {
    "city": "北京",
    "district": "海淀区"
  }
}

对象（Object）是编程语言中的数据结构，用于存储属性和方法，由于JSON是文本格式，无法直接被程序处理，而对象是内存中的数据结构，无法直接在网络中传输或存储，因此需要将对象转换为JSON串（序列化），反之亦然（反序列化）。

主流语言中Object转JSON串的方法

JavaScript：原生方法与JSON.stringify()

JavaScript中转换Object为JSON串最常用的是JSON.stringify()方法，这是ECMAScript 5引入的内置函数，支持所有现代浏览器和Node.js。

基本用法

JSON.stringify()接收一个对象作为参数，返回对应的JSON字符串：

const user = {
  name: "李四",
  age: 30,
  isAdmin: true
};
const jsonString = JSON.stringify(user);
console.log(jsonString); 
// 输出: {"name":"李四","age":30,"isAdmin":true}

高级用法：参数控制格式与过滤

JSON.stringify()支持第二个和第三个参数，用于控制转换过程：

• 第二个参数（replacer）：过滤或转换属性值，可以是函数或数组。

  • 若为函数,对每个属性调用，返回值会被序列化（若返回undefined则忽略该属性）；
  • 若为数组,只包含数组中的属性名。

  const user = {
    name: "王五",
    age: 28,
    password: "123456", // 敏感信息，不希望出现在JSON中
    hobbies: ["阅读", "游泳"]
  };
  // 使用函数过滤敏感信息
  const filteredJson = JSON.stringify(user, (key, value) => {
    if (key === "password") return undefined; // 忽略password属性
    return value;
  });
  console.log(filteredJson); 
  // 输出: {"name":"王五","age":28,"hobbies":["阅读","游泳"]}
  // 使用数组只保留指定属性
  const selectedJson = JSON.stringify(user, ["name", "hobbies"]);
  console.log(selectedJson); 
  // 输出: {"name":"王五","hobbies":["阅读","游泳"]}

• 第三个参数（space）：格式化输出，用于美化JSON串（便于调试），可以是数字（表示缩空格数，最大10）或字符串（用字符串代替空格）。

  const user = {
    name: "赵六",
    details: {
      address: "上海",
      occupation: "工程师"
    }
  };
  // 使用数字缩进（2个空格）
  const prettyJson = JSON.stringify(user, null, 2);
  console.log(prettyJson);
  /* 输出:
  {
    "name": "赵六",
    "details": {
      "address": "上海",
      "occupation": "工程师"
    }
  }
  */

注意事项

• 循环引用：若对象中存在循环引用（如obj.a = obj），JSON.stringify()会抛出错误TypeError: Converting circular structure to JSON。
  解决方案：手动处理循环引用，或使用第三方库（如flatted、cycle.js）。

• 特殊类型处理：

  • undefined、Function、Symbol类型的属性会被忽略；
  • Date对象会被转换为字符串（如"2023-10-01T12:00:00.000Z"）；
  • RegExp对象会被转换为空对象。

  const obj = {
    name: "测试",
    date: new Date(),
    fn: function() { return "hello"; },
    undef: undefined
  };
  console.log(JSON.stringify(obj)); 
  // 输出: {"name":"测试","date":"2023-10-01T12:00:00.000Z"}

Python：json模块与dumps()

Python中通过内置的json模块实现Object与JSON串的转换，核心方法是json.dumps()（dumps = dump string）。

基本用法

json.dumps()接收一个Python对象（如字典、列表），返回JSON字符串：

import json
user = {
    "name": "钱七",
    "age": 35,
    "is_teacher": True,
    "courses": ["物理", "化学"],
    "address": {
        "city": "广州",
        "area": "天河区"
    }
}
json_string = json.dumps(user)
print(json_string)
# 输出: {"name": "钱七", "age": 35, "is_teacher": true, "courses": ["物理", "化学"], "address": {"city": "广州", "area": "天河区"}}

高级用法：参数控制格式与编码

json.dumps()支持多个参数，常用参数包括：

• indent：缩进空格数，用于美化输出（类似JavaScript的space）；
• ensure_ascii：是否将非ASCII字符转为ASCII编码（默认True，中文会转成\u格式）；
• default：自定义类型转换函数（处理datetime、Decimal等Python特殊类型）。

import json
from datetime import datetime
user = {
    "name": "孙八",
    "join_time": datetime.now(),
    "score": 98.5
}
# 美化输出 + 保留中文
pretty_json = json.dumps(user, indent=2, ensure_ascii=False)
print(pretty_json)
/* 输出:
{
  "name": "孙八",
  "join_time": "2023-10-01 12:00:00.000000",
  "score": 98.5
}
*/
# 自定义datetime转换
def datetime_handler(obj):
    if isinstance(obj, datetime):
        return obj.strftime("%Y-%m-%d %H:%M:%S")
    raise TypeError(f"Object of type {type(obj)} is not JSON serializable")
custom_json = json.dumps(user, default=datetime_handler)
print(custom_json)
# 输出: {"name": "孙八", "join_time": "2023-10-01 12:00:00", "score": 98.5}

注意事项

• Python对象与JSON类型的映射：Python的dict/list对应JSON的object/array，str/int/float/bool/None分别对应JSON的string/number/number/boolean/null；
• 特殊类型处理：Python的datetime、set、Decimal等类型无法直接序列化，需通过default参数自定义转换逻辑；
• 循环引用：同样会抛出TypeError，需手动处理或使用第三方库（如orjson、ujson）。

Java：Jackson/Gson库与序列化

Java中没有内置的JSON处理方法,需依赖第三方库，主流选择有Jackson、Gson、Fastjson等，本文以Jackson（Spring Boot默认使用）和Gson为例。

使用Jackson（依赖：com.fasterxml.jackson.core:jackson-databind）

Jackson通过ObjectMapper类实现序列化，核心方法是writeValueAsString()。

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
public class JacksonExample {
    public static void main(String[] args) {
        // 创建User对象
        User user = new User("周九", 28, true, 
                new String[]{"Java", "Spring"}, 
                new Address("深圳", "南山区"));
        // ObjectMapper实例
        ObjectMapper objectMapper = new ObjectMapper();
        try {
            // 转换为JSON串
            String jsonString = objectMapper.writeValueAsString(user);
            System.out.println(jsonString);
            // 输出: {"name":"周九","age":28,"isStudent":true,"courses":["Java","Spring"],"address":{"city":"深圳","district":"南