js对象转json字符串有哪些常用方法

在JavaScript开发中，将js对象转换为json字符串是非常基础且常用的操作，无论是前后端数据交互、本地存储数据还是数据序列化场景，都会用到这个转换能力。js对象本身是内存中的数据结构，而json字符串是文本格式，更便于传输和持久化保存。

使用JSON.stringify原生方法转换

JSON.stringify是JavaScript内置的用于对象序列化的方法，也是最常用的js对象转json字符串的方式，它可以直接将符合json规范的对象转换为对应的字符串。

基础转换示例

对于普通的对象，直接调用JSON.stringify即可完成转换，代码如下：

// 定义一个普通js对象
const user = {
    name: '张三',
    age: 25,
    isStudent: false
};
// 转换为json字符串
const jsonStr = JSON.stringify(user);
console.log(jsonStr); 
// 输出: {"name":"张三","age":25,"isStudent":false}

处理转换参数

JSON.stringify支持三个参数，第二个参数是替换器，可以是函数或者数组，用来筛选要转换的属性；第三个参数是缩进值，用来格式化输出的字符串。

比如只转换对象中的指定属性：

const user = {
    name: '张三',
    age: 25,
    address: '北京',
    phone: '13800138000'
};
// 只保留name和age属性
const jsonStr = JSON.stringify(user, ['name', 'age']);
console.log(jsonStr); 
// 输出: {"name":"张三","age":25}

如果需要格式化的字符串，可以设置第三个参数：

const user = {
    name: '张三',
    age: 25
};
// 缩进2个空格
const jsonStr = JSON.stringify(user, null, 2);
console.log(jsonStr);
// 输出:
// {
//   "name": "张三",
//   "age": 25
// }

特殊场景的转换处理

处理对象中的函数、undefined等属性

JSON.stringify在转换时，会自动忽略对象中的函数、undefined、Symbol类型的属性，也不会转换原型链上的属性。

const obj = {
    name: '测试',
    sayHello: function() {
        console.log('hello');
    },
    age: undefined,
    id: Symbol('id')
};
const jsonStr = JSON.stringify(obj);
console.log(jsonStr); 
// 输出: {"name":"测试"}

处理循环引用的对象

如果对象存在循环引用，直接使用JSON.stringify会抛出错误，这时候需要自定义替换器来处理循环引用的情况。

// 处理循环引用的函数
function handleCircular(obj) {
    const seen = new WeakSet();
    return JSON.stringify(obj, (key, value) => {
        if (typeof value === 'object' && value !== null) {
            if (seen.has(value)) {
                return;
            }
            seen.add(value);
        }
        return value;
    });
}

const obj = {};
obj.self = obj; // 循环引用
const jsonStr = handleCircular(obj);
console.log(jsonStr); 
// 输出: {"self":null}

转换注意事项

• JSON.stringify只能转换符合json规范的数据，Date对象会被转换为字符串形式的日期，RegExp对象会被转换为空对象。
• 如果对象中有toJSON方法，JSON.stringify会优先调用该方法的返回值作为转换结果。
• 转换后的json字符串中，属性名和字符串值都会用双引号包裹，不能使用单引号，否则不符合json规范。

自定义转换方法

如果不想使用原生方法，也可以自己实现简单的对象转json字符串的逻辑，不过这种方式只适合处理简单的对象，复杂场景还是推荐使用JSON.stringify。

function objToJson(obj) {
    if (typeof obj !== 'object' || obj === null) {
        if (typeof obj === 'string') {
            return `"${obj}"`;
        }
        return String(obj);
    }
    const arr = [];
    for (let key in obj) {
        if (obj.hasOwnProperty(key)) {
            const value = obj[key];
            arr.push(`"${key}":${objToJson(value)}`);
        }
    }
    return `{${arr.join(',')}}`;
}

const user = {
    name: '李四',
    age: 30
};
const jsonStr = objToJson(user);
console.log(jsonStr); 
// 输出: {"name":"李四","age":30}

JSON_stringifyjs对象json字符串对象序列化修改时间：2026-07-12 22:57:24