答案：使用 replacer 函数结合 WeakSet 可解决循环引用并自定义序列化逻辑，或引入 flatted 等库实现完整结构还原，同时利用 replacer 与 reviver 控制字段过滤与类型转换。
在使用 JavaScript 的 JSON.stringify() 方法进行对象序列化时，遇到循环引用会抛出错误。同时，在某些场景下，我们希望对序列化过程进行自定义控制，比如过滤字段或处理特殊类型。本文将说明如何解决循环引用问题，并实现自定义的 JSON 序列化与解析逻辑。
循环引用导致的问题
当一个对象的属性直接或间接引用自身时，就构成了循环引用。例如：
const obj = { name: "Alice" };
obj.self = obj;
JSON.stringify(obj); // 抛出 TypeError: Converting circular structure to JSON
浏览器和 Node.js 环境下的原生 JSON.stringify 无法处理这种结构，会立即中断并报错。
解决方案：使用 replacer 函数过滤引用
可以通过传入 replacer 函数来跳过特定属性。虽然不能直接检测所有循环引用，但可以结合 WeakSet 手动追踪已访问的对象：
立即学习“Java免费学习笔记（深入）”；
function stringifySafe(obj) {
const seen = new WeakSet();
return JSON.stringify(obj, (key, value) => {
if (typeof value === "object" && value !== null) {
if (seen.has(value)) {
return "[Circular]";
}
seen.add(value);
}
return value;
});
}
这个方法能在序列化过程中识别重复引用，避免崩溃，同时用标记字符串代替循环部分，保留其余数据结构。
使用第三方库简化处理
对于复杂项目，推荐使用专门处理循环引用的库，如 flatted 或 cycle。
Teleport tsh SSH (Identity-First SSH Access, no passwords/static keys)
下载
使用tbot机器ID身份文件配合tsh CLI，通过Teleport访问控制SSH登录托管主机或执行远程命令。
以 flatted 为例：
import { stringify, parse } from 'flatted';
const obj = { name: "Bob" };
obj.self = obj;
const str = stringify(obj); // 成功序列化
const recovered = parse(str); // 正确还原结构
这类库通过扁平化结构记录引用关系，能完整保存和恢复循环引用，适合需要精确还原的场景。
自定义序列化与反序列化逻辑
除了处理循环引用，有时还需控制哪些字段被序列化，或转换日期、函数等非标准类型。
replacer 和 reviver 参数提供了这样的能力：
- replacer：在序列化前筛选或转换值
- reviver：在反序列化后修正或重建值
const user = {
name: "Charlie",
password: "123456", // 敏感字段
createdAt: new Date()
};
// 自定义序列化：隐藏密码，转换日期为时间戳
const json = JSON.stringify(user, (key, value) => {
if (key === "password") return undefined;
if (value instanceof Date) return value.getTime();
return value;
});
// 反序列化时恢复日期对象
const parsed = JSON.parse(json, (key, value) => {
if (key === "createdAt") return new Date(value);
return value;
});
这样可以在传输中精简数据，同时保证关键信息正确重建。
基本上就这些。处理循环引用和自定义解析并不复杂，关键是理解 replacer 与 reviver 的执行时机，并根据需求选择手动控制或引入可靠工具库。
