WeakSet 与 Set 的核心区别在于：WeakSet 仅存储对象且为弱引用，不阻止垃圾回收，不可遍历、无 size 属性和 clear 方法；而 Set 支持任意类型值、强引用，功能完整。

WeakSet 是 JavaScript 中用于存储对象引用的弱集合，它的成员只能是对象，且不阻止垃圾回收——这意味着只要对象在其他地方不再被引用，WeakSet 里的对应条目会自动消失。

WeakSet 和 Set 的核心区别在哪？

最直接的区别在于引用强度和值类型限制：

• WeakSet 只接受对象（Object、Array、Map、Function 等），传入原始值（如 42、"str"、true）会立即抛出 TypeError: Invalid value used in weak set
• WeakSet 持有对象的「弱引用」：如果一个对象只被 WeakSet 引用，它会被 GC 回收，WeakSet 内部条目随之消失；而 Set 是强引用，会阻止回收
• WeakSet 不可遍历：没有 .keys()、.values()、.entries()，也没有 .forEach()，只有 .add()、.has()、.delete()
• WeakSet 不能被清空（无 .clear()），也不能获取大小（无 .size 属性）

WeakSet 常见错误用法和报错场景

这些错误在开发中高频出现，往往源于对「弱引用」或「仅对象」约束理解不到位：

• 试图用 new WeakSet([1, 2, 3]) 初始化 —— 报错：TypeError: Invalid value used in weak set，因为数组里含原始值
• 写 weakSet.size 或 weakSet.forEach(...) —— 报错：TypeError: weakSet.size is not a function 或 undefined is not a function
• 误以为 weakSet.has(obj) 能长期稳定返回 true —— 实际上一旦 obj 在别处被释放，下次调用可能就返回 false，无法用于持久状态判断
• 在循环中反复 add 同一个临时对象（如 {id: i}），却期望后续能 has 到它 —— 失败，因为每次都是新对象，且无外部引用，很快被回收

适合 WeakSet 的真实使用场景

WeakSet 不是用来替代 Set 的，它的价值在于「轻量级、无内存泄漏风险的对象标记」：

• 避免循环引用导致的内存泄漏：比如在 DOM 元素上打标记，又不想阻止元素被回收。例如实现一个 isProcessed 标记器：

  const processed = new WeakSet();
  function handleElement(el) {
    if (processed.has(el)) return;
    // ...处理逻辑
    processed.add(el);
  }

  页面卸载后，el 自动从 processed 中消失
• 私有状态模拟（配合闭包）：把某个类的实例是否已初始化过、是否正在渲染等状态存在 WeakSet 中，避免在实例上挂属性暴露给外部，也无需手动清理
• 临时去重（仅限对象）：比如递归遍历树结构时，用 WeakSet 记录已访问过的节点对象，防止无限循环，且不干扰节点生命周期

WeakSet 不适合做什么？

容易被忽略但很关键的一点：WeakSet 不提供任何「存在性保障」。它不是缓存，也不是状态容器。如果你需要：

• 长期记住某个对象是否被标记 → 用 Map 或普通对象（但注意内存管理）
• 枚举所有当前存在的标记对象 → WeakSet 无法做到，必须换方案
• 跨函数/模块共享可预测的标记结果 → WeakSet 的不确定性会让调试变得困难
• 对非对象做集合操作 → 必须用 Set

WeakSet 的设计哲学是「辅助型工具」，它的力量恰恰来自它的局限性：不暴露内部、不干涉生命周期、不承诺稳定性。用错地方，反而比不用更难排查。