Map字典实时统计键值对数量的方法

JavaScript 中的 Map 对象内置了高效、实时且完全可靠的 size 属性，它在每次增删操作后自动精确更新，无需手动维护计数器，也绝不能用 Object.keys(map).length 或展开迭代器等低效甚至错误的方式替代——这些做法不仅性能差（O(n)）、语义错（返回0），还易引入难以排查的 bug；无论 key 是原始值还是对象、是否被外部引用，size 始终准确反映当前真实键值对数量，且在 TypeScript 中被严格定义为只读类型，是安全、简洁、高性能的首选方案。

Map.size 是实时的，不用手动维护

JavaScript 中的 Map 对象自带 size 属性，它始终反映当前键值对数量，增删操作后自动更新，不是快照也不是缓存值。

常见错误是自己定义一个计数器变量，在 set() 或 delete() 后手动加减——这不仅多余，还容易出错（比如漏掉 clear()、set() 重复 key 不触发新增等场景）。

• map.set('a', 1) → map.size 立即变为 1
• map.set('a', 2) → map.size 仍为 1（key 未变，不增加数量）
• map.delete('b') → 若 key 不存在，size 不变
• map.clear() → size 立即归零

size 和 Object.keys(obj).length 的区别不能混用

你不能用 Object.keys(myMap).length 替代 myMap.size ——因为 Map 不是普通对象，Object.keys() 返回空数组，结果永远是 0。

这个错误多出现在把 Map 当成普通对象处理时，比如误以为能用 for...in 遍历或想用 JSON.stringify() 直接序列化 size。

• Object.keys(new Map([['a', 1]])) → []（不是 ['a']）
• JSON.stringify(new Map([['a', 1]])) → "{}"（Map 默认不可序列化）
• 要转成数组再取长度？用 map.entries().length 不行（Iterator 无 length），得用 [...map].length，但这是 O(n)，而 size 是 O(1)

size 在弱引用或垃圾回收场景下依然准确

Map 的 size 只统计当前实际存在的键值对，和 key 是否为对象、是否被其他地方引用无关。哪怕 key 是一个仅被该 Map 持有的对象，只要没被 delete 或 clear，就会计入 size。

注意：这不是 WeakMap —— Map 会强持有 key，所以 size 不会因为外部引用消失而自动减少。

• const key = {}; const map = new Map([[key, 'val']]); → map.size === 1
• key = null; → map.size 仍是 1（key 仍被 map 持有）
• 想实现自动清理？必须换用 WeakMap，但它没有 size 属性（设计如此）

TypeScript 类型里 size 是只读 number

在 TS 中，Map.size 的类型是 readonly number，编译期禁止赋值，运行时也写不了——这点比手写计数器更安全。

如果你在类型检查中看到 Property 'size' is missing，那大概率是你 mock 了一个假 Map 对象，没正确实现 size getter。

• 别这样写：const fakeMap = { set() {}, get() {}, size: 0 }（类型和行为都不对）
• 测试中需要可控 Map？直接用真实 new Map()，它轻量且可测
• 需要拦截 size？不可能——它是原生属性，无法代理或覆盖（Object.defineProperty(map, 'size', ...) 会静默失败）

理论要掌握，实操不能落！以上关于《Map字典实时统计键值对数量的方法》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！