JavaScript Map是ES6标准中新增的一种内置数据结构，它的核心作用就是存储键值对，和传统的Object对象功能类似，但在键的类型支持、迭代性能、键值对操作等方面有明显差异，更适合需要频繁增删键值对的场景。
Map的基本概念
Map本质上是一个可迭代的键值对集合，它的键可以是任意类型的值，包括原始类型（如数字、字符串、布尔值）、对象、函数等，这一点和Object只能使用字符串或者Symbol作为键有很大区别。Map内部会维护键值对的插入顺序，迭代的时候会按照插入顺序依次返回键值对。
我们可以通过new Map()构造函数来创建一个Map实例，构造函数支持传入一个可迭代的键值对数组作为初始值，示例代码如下：
// 创建空Map
const emptyMap = new Map();
// 创建带初始值的Map，初始值是二维数组，每个子数组的第一个元素是键，第二个是值
const initMap = new Map([
['name', '张三'],
[18, '年龄'],
[{ id: 1 }, '对象作为键']
]);
console.log(initMap.size); // 输出3，size属性表示Map中键值对的数量
Map的核心操作方法
Map提供了一系列操作键值对的方法，常用的有以下几种：
- set(key, value)：向Map中添加新的键值对，如果键已经存在则更新对应的值，返回Map实例本身，支持链式调用。
- get(key)：根据键获取对应的值，如果键不存在则返回undefined。
- has(key)：判断Map中是否存在指定的键，返回布尔值。
- delete(key)：删除指定键对应的键值对，删除成功返回true，否则返回false。
- clear()：清空Map中所有的键值对，没有返回值。
下面是这些方法的简单使用示例：
const userMap = new Map();
// 添加键值对
userMap.set('name', '李四')
.set('age', 20)
.set('hobby', '篮球');
console.log(userMap.get('name')); // 输出李四
console.log(userMap.has('age')); // 输出true
userMap.delete('hobby');
console.log(userMap.has('hobby')); // 输出false
userMap.clear();
console.log(userMap.size); // 输出0
Map如何存储键值对
Map的存储机制并不是像Object那样依赖原型链和属性描述符，它的内部实现通常采用哈希表结合链表（或者红黑树）的结构，具体存储逻辑如下：
键的哈希处理
当向Map中添加一个键值对时，首先会对键进行哈希计算，生成一个对应的哈希值。对于不同类型的键，哈希计算的方式不同：
- 对于原始类型的键，直接使用值本身的特征计算哈希，比如数字键的哈希就是数字本身，字符串键会根据字符串的内容计算哈希值。
- 对于对象类型的键，Map会使用对象的内存地址作为哈希计算的依据，这也是为什么两个不同的空对象作为键时，会被认为是不同的键，示例：
const objMap = new Map();
const obj1 = {};
const obj2 = {};
objMap.set(obj1, '对象1');
objMap.set(obj2, '对象2');
console.log(objMap.get(obj1)); // 输出对象1
console.log(objMap.get(obj2)); // 输出对象2
console.log(objMap.get({})); // 输出undefined，新空对象和obj1、obj2内存地址不同
哈希冲突的处理
如果不同的键计算出了相同的哈希值，就会产生哈希冲突，Map内部会通过链表或者红黑树来保存这些哈希值相同的键值对，当查询的时候，先通过哈希值定位到对应的桶，再遍历桶内的键值对，通过严格相等（===）比较键是否匹配，匹配到就返回对应的值。
顺序维护
Map会额外维护一个插入顺序的链表，每次添加键值对的时候，会把新的键值对节点追加到链表末尾，迭代的时候按照这个链表的顺序依次返回，所以Map的迭代顺序是固定的插入顺序，这和Object的键遍历顺序（先数字键升序，再字符串键、Symbol键插入顺序）有明显区别。
Map和Object的对比
为了更清楚Map的适用场景，我们可以对比一下Map和Object的差异：
| 对比项 | Map | Object |
|---|---|---|
| 键的类型 | 任意类型 | 仅字符串、Symbol |
| 键值对数量获取 | size属性直接获取 | 需要手动计算Object.keys(obj).length |
| 迭代性能 | 原生支持迭代，频繁增删时性能更好 | 需要转换才能迭代，频繁增删时可能有性能损耗 |
| 默认键 | 没有默认键，不会和原型链属性冲突 | 有原型链上的默认属性，可能存在键冲突 |
Map的迭代方式
Map是可迭代对象，支持多种迭代方式：
- for...of循环：直接迭代Map，每次返回[key, value]形式的数组。
- forEach方法：遍历所有键值对，回调函数参数依次是value、key、map本身。
- keys()、values()、entries()方法：分别返回键的迭代器、值的迭代器、键值对的迭代器。
迭代示例代码如下：
const demoMap = new Map([
['a', 1],
['b', 2]
]);
// for...of迭代
for (const [key, value] of demoMap) {
console.log(key, value); // 依次输出 a 1、b 2
}
// forEach迭代
demoMap.forEach((value, key) => {
console.log(key, value); // 依次输出 a 1、b 2
});
// entries迭代
for (const item of demoMap.entries()) {
console.log(item); // 依次输出 ['a', 1]、['b', 2]
}
使用注意事项
在使用Map的时候需要注意以下几点：
- Map的键的比较使用的是严格相等（===），但是NaN是个例外，Map认为NaN等于NaN，所以可以用NaN作为键，并且同一个Map中只能有一个NaN键。
- 如果需要把对象作为键，并且希望对象的属性变化不影响键的匹配，需要注意Map是根据对象的内存地址来判断键是否相同的，修改对象的属性不会改变内存地址，所以还是能匹配到对应的键值对。
const nanMap = new Map();
nanMap.set(NaN, 'not a number');
console.log(nanMap.get(NaN)); // 输出not a number，说明Map认为NaN等于NaN
const keyObj = { x: 1 };
const testMap = new Map();
testMap.set(keyObj, '初始值');
keyObj.x = 2; // 修改对象属性，内存地址不变
console.log(testMap.get(keyObj)); // 输出初始值，依然能匹配到
总的来说，当我们存储的键不是字符串或者Symbol，或者需要频繁增删键值对、需要固定的插入顺序迭代时，优先选择Map作为存储结构，能获得更好的代码可读性和性能表现。
JavaScriptMap键值对数据结构修改时间：2026-06-24 00:51:47