JSON.stringify遇循环引用会立即抛错而非死循环，因引擎在入口阶段检测到重复内存地址即终止；须用WeakMap+replacer提前拦截或先调用structuredClone解环再序列化。
JSON.stringify 遇到循环引用会直接抛错，不是卡在“死循环”里，而是引擎在序列化入口阶段就检测到重复内存地址，立刻终止并报 TypeError: Converting circular structure to JSON。它根本不会进入无限递归，所以这不是性能问题，而是格式校验失败。防止报错的关键，是在 stringify 执行前或执行中主动拦截重复对象引用。
用 WeakMap + replacer 提前拦截
这是最轻量、可控且不污染原始数据的通用做法。核心是：用 WeakMap 记录已遍历的对象引用，replacer 函数在每次访问值时检查是否见过它。
- 只对
typeof value === 'object' && value !== null的值做检查，跳过函数、undefined、Symbol 等本就不合法的类型 - WeakMap 不会造成内存泄漏，键是对象引用，值可任意（如
true或占位符） - 若已存在，返回
'[Circular]'（便于定位）、null（保留字段但置空）或undefined（彻底剔除该字段）
示例：
const seen = new WeakMap();
const replacer = (key, value) => {
if (typeof value === 'object' && value !== null) {
if (seen.has(value)) return '[Circular]';
seen.set(value, true);
}
return value;
};
JSON.stringify(obj, replacer);
优先用 structuredClone 先解环再序列化
现代环境（Chrome 98+ / Firefox 94+ / Node.js 17.0+）推荐这条路径：structuredClone 本身就能安全处理循环引用、Map、Set、Date 等，生成的是一个无环的新对象，之后再 JSON.stringify 就不会出错。
立即学习“Java免费学习笔记（深入）”；
- 调用
structuredClone(obj)得到深拷贝，原始循环已被“展开”为独立引用 - 接着
JSON.stringify(structuredClone(obj))即可安全输出字符串 - 注意：structuredClone 不支持函数、undefined、BigInt、Promise —— 这些本来也不属于 JSON 合法类型，需提前过滤或替换
调试时直接用 console.dir 查看结构
不需要序列化也能看清循环关系。浏览器控制台的 console.dir(obj, { depth: null }) 内置了循环检测，会把重复引用标为 [Circular]，支持交互式展开，比硬写 replacer 更快定位问题源头。
- 配合
structuredClone(obj)一起试：如果 clone 成功，说明是良性循环，可安全克隆；如果也报错，则可能含 DOM 节点、window、MobX observable 等不可克隆对象 - 看到
[Circular]标记后，就能快速判断是设计使然（如父子关系），还是意外引入的冗余引用
别硬扛，该换协议就换协议
如果业务需要保留引用语义（比如后端要还原对象图），JSON 本身就不适合。这时应跳出 JSON 思维：
- 前端调试用
flatted.stringify()（输出标准 JSON 字符串，含$ref字段，parse 可还原） - 服务端通信改用 MessagePack 或 Protocol Buffers，它们原生支持引用和二进制高效传输
- 状态持久化（如 localStorage）避免存整个 store，改存扁平化的关键字段或用 IndexedDB 存原生对象
