JavaScript中循环引用对象无法直接用JSON.stringify()转换，会抛出TypeError错误；根本原因是JSON格式不支持引用关系，导致无限递归；常用解决方案包括：①自定义replacer函数配合WeakMap跳过循环引用；②现代环境可用structuredClone预处理；③第三方库如flatted可完整保留循环结构；④手动解构生成调试快照。
JavaScript 中循环引用对象无法直接用 JSON.stringify() 转换，会抛出 TypeError: Converting circular structure to JSON 错误。根本原因是 JSON 格式不支持引用关系，而循环引用会让序列化过程无限递归。
用自定义 replacer 函数跳过循环引用属性
这是最常用、轻量且可控的方式：在 JSON.stringify() 的第二个参数（replacer）中识别并过滤掉已出现过的对象引用。
- 维护一个 WeakMap 记录已遍历的对象及其占位标识（如
"[Circular]"） - 在 replacer 中检查当前值是否已在 WeakMap 中，若是则返回替代值（如
null或字符串标记） - 注意：WeakMap 只能以对象为键，天然避免内存泄漏
const seen = new WeakMap();
function getCircularReplacer() {
return (key, value) => {
if (typeof value === "object" && value !== null) {
if (seen.has(value)) {
return "[Circular]";
}
seen.set(value, true);
}
return value;
};
}
const obj = { a: 1 };
obj.self = obj;
console.log(JSON.stringify(obj, getCircularReplacer())); // {"a":1,"self":"[Circular]"}
使用结构化克隆 + 序列化（现代环境推荐）
如果目标环境支持 structuredClone()（Chrome 98+、Firefox 94+、Node.js 17.0+），可先深拷贝去除引用关系，再安全序列化。
- structuredClone 能正确处理大多数内置类型（包括 Map、Set、Date、RegExp 等），但依然不支持函数、undefined、Symbol 和循环引用
- 所以它本身也会报错——需配合 try/catch 或先用 replacer 预处理
- 更稳妥的做法是：用 replacer 清除循环后，再用 structuredClone 做一次干净副本（可选）
借助第三方库（如 flatted、circular-json 已废弃）
对于复杂场景或需要反向还原（即从 JSON 再恢复带循环的对象），可使用 flatted。
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
立即学习“Java免费学习笔记（深入）”；
- 安装：
npm install flatted - 它用数字索引代替重复引用，生成的字符串仍是合法 JSON（含额外元信息）
- 支持
flatted.stringify()和flatted.parse()，可完整保留循环结构
import { stringify, parse } from 'flatted';
const obj = { name: 'Alice' };
obj.friend = obj;
const json = stringify(obj); // '{"name":"Alice","friend":1}'
const restored = parse(json); // 恢复为带循环的对象
手动解构：只保留必要字段（适合调试或日志）
若只是临时查看结构（如 console.log 或发送日志），无需严格 JSON 兼容，可写一个简易“扁平快照”函数：
- 递归遍历时记录路径和基础类型值（string/number/boolean/null）
- 遇到对象或数组时，只展开一层，深层用
[Object]或[Array]表示 - 遇到循环引用直接标记为
[Circular ~path]，便于定位
这种方式不生成标准 JSON，但对排查问题非常高效，也避免了序列化开销。
