日常在 JavaScript 中，尝试对含有循环引用的对象进行 JSON 序列化时，JSON.stringify 会抛出错误：

const obj = {};
obj.self = obj; // 循环引用

JSON.stringify(obj); // 抛出 TypeError: Converting circular structure to JSON

那么如何处理 JSON 中的循环结构？为了解决这个问题，可以采用以下方法：

---

1. 使用 JSON.stringify 的 replacer 参数

• 自定义一个 replacer 函数，在序列化时检测到循环引用后进行处理。
• 利用一个集合（如 Set）记录已经访问过的对象。 示例：

   const obj = { name: "Alice" };
   obj.self = obj; // 循环引用

   function safeStringify(obj) {
       const seen = new Set();
       return JSON.stringify(obj, (key, value) => {
           if (typeof value === "object" && value !== null) {
               if (seen.has(value)) {
                   return "[Circular]"; // 用特殊标记处理循环引用
               }
               seen.add(value);
           }
           return value;
       });
   }

   console.log(safeStringify(obj));
   // 输出: {"name":"Alice","self":"[Circular]"}

---

2. 使用第三方库

• 使用专门处理循环引用的库，例如 circular-json 或 flatted。
• 这些库提供了支持循环引用的序列化与反序列化功能。 安装库（以 flatted 为例）：

   npm install flatted

使用示例：

   const { stringify, parse } = require("flatted");

   const obj = { name: "Alice" };
   obj.self = obj;

   const serialized = stringify(obj);
   console.log(serialized); // 输出: {"name":"Alice","self":"~"}

   const deserialized = parse(serialized);
   console.log(deserialized);
   // 输出: { name: 'Alice', self: [Circular] }

---

3. 深拷贝对象，移除循环引用

• 手动遍历对象，移除循环引用或将其替换为其他值（如 null）。
• 适合序列化前预处理对象。 示例：

   function removeCircular(obj, seen = new Set()) {
       if (typeof obj !== "object" || obj === null) return obj;

       if (seen.has(obj)) return null; // 检测到循环引用，返回 null
       seen.add(obj);

       const result = Array.isArray(obj) ? [] : {};
       for (const key in obj) {
           result[key] = removeCircular(obj[key], seen);
       }
       return result;
   }

   const obj = { name: "Alice" };
   obj.self = obj;

   const cleanObj = removeCircular(obj);
   console.log(JSON.stringify(cleanObj)); // 输出: {"name":"Alice","self":null}

---

4. 使用 WeakSet 动态检测循环引用

• WeakSet 只存储对象的弱引用，不影响垃圾回收。
• 避免占用额外的内存。 示例：

   function safeStringify(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;
       });
   }

   const obj = { name: "Alice" };
   obj.self = obj;

   console.log(safeStringify(obj));
   // 输出: {"name":"Alice","self":"[Circular]"}

---

总结

• 简单处理：自定义 replacer 或手动深拷贝。
• 推荐方法：使用 WeakSet 简化循环引用检测。
• 复杂场景：引入第三方库（如 flatted）可靠解决。

根据实际需求选择合适的方法即可高效处理循环结构的序列化问题。

以上为在 JavaScript 中序列化 JSON 时如何有效处理循环结构的详细内容，更多信息请关注其他相关文章！