Map 和 Set 不是语法糖，而是专为键值映射唯一性和值集合去重设计的数据结构；它们支持任意类型 key（含对象、NaN）、SameValueZero 判等、插入顺序遍历，且增删性能优于 Object，但不可替代数组或滥用为“高级对象”。
Map 和 Set 不是语法糖，也不是数组替代品——它们解决的是「键值映射唯一性」和「值集合去重」这两类不可被数组高效覆盖的场景。用错地方反而拖慢性能，比如用 Array.includes() 查 10 万条数据是否在集合里，比 Set.has() 慢两个数量级。
Map 的 key 可以是任意类型，但要注意引用相等性
Object 只接受字符串或 Symbol 作 key，而 Map 允许函数、对象、甚至 NaN 作为 key——但判断是否为同一 key 时用的是 SameValueZero 算法（类似 ===，但 NaN === NaN 为 false，而 Map 中 NaN 能正确匹配）。
常见错误：用普通对象当 key 却期望自动去重：
const map = new Map();
const obj1 = { id: 1 };
const obj2 = { id: 1 };
map.set(obj1, 'a');
map.set(obj2, 'b'); // 这不会覆盖，而是新增一项 —— 因为 obj1 !== obj2
console.log(map.size); // 输出 2，不是 1
正确做法：
立即学习“Java免费学习笔记（深入）”；
- 若需按对象内容判等，先序列化（如
JSON.stringify(obj)）再作 key，但注意函数、undefined、Symbol 会丢失 - 若 key 是 DOM 元素或第三方类实例，直接用原对象即可，Map 内部用弱引用机制管理（不阻止 GC）
- 避免用
new Date()或new RegExp()等每次新建的值作 key，除非你明确需要多次存入
Set 判断重复靠 SameValueZero，null 和 undefined 各算一个
Set 去重逻辑和 Map 的 key 判等一致，所以：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
-
NaN只会被存一次：new Set([NaN, NaN])大小为 1 -
null和undefined是不同值：new Set([null, undefined])大小为 2 - 对象即使内容相同也视为不同：
new Set([{a:1}, {a:1}])大小为 2
别用 Array.from(new Set(arr)) 替代 [...new Set(arr)]——两者等价，但后者更简洁；真正要注意的是嵌套数组或对象去重必须手动处理，Set 不递归深比较。
Map 与 Object 性能差异在动态增删频繁时才明显
如果只是静态配置项（如 { theme: 'dark', lang: 'zh' }），用普通对象更轻量、可枚举、支持解构，还兼容 JSON。Map 的优势场景是：
- 运行时高频
set()/delete()（Map 是 O(1)，而 delete object[key] 后 for…in 遍历顺序不可控，且无法保证枚举顺序） - 需要保持插入顺序遍历（
Map.prototype.keys()/values()/entries()都按插入顺序返回） - key 类型不确定，又不想 toString() 强转（比如用
document.body当 key 缓存某元素状态）
反例：把 Map 当做“高级对象”滥用，结果调试时发现控制台显示 Map(3) {…}，不能像对象那样点开看结构——得调用 map.entries() 或展开迭代器。
从数组快速构建 Map / Set 的陷阱
new Map(array) 要求数组每一项是长度为 2 的可迭代对象（如 [[k1,v1], [k2,v2]]），传错格式会静默失败：
new Map([{ id: 1, name: 'a' }, { id: 2, name: 'b' }]); // 报错：TypeError: Iterator value is not an entry object
正确方式：
- 从对象数组生成 Map：
new Map(arr.map(item => [item.id, item])) - 从二维数组生成 Set：
new Set(arr.flat())（注意 flat 默认只展一层） - 用
Array.from(set, fn)或[...set].map()转回数组，别用set.map()（Set 没有 map 方法）
最易忽略的一点：Map 和 Set 都是可迭代对象，但不继承自 Array，所以没有 push、filter、find 等方法——该用 for…of、Array.from() 或扩展运算符的地方，别硬套数组 API。
