怎么用二维数组快速初始化JS Map

核心语法与构造约定

Map 构造函数 new Map([iterable]) 接收一个可选的可迭代对象。当传入二维数组时，外层数组充当可迭代容器，内层每一个子数组则代表一个独立的键值条目（Entry）。

每个子数组的索引 [0] 作为 Map 的键，索引 [1] 作为对应的值。基础示例如下：

// 基础二维数组初始化
const userEntries = [
  ['userId', 1001],
  ['username', 'chen_lin'],
  ['role', 'editor']
];

const userMap = new Map(userEntries);

console.log(userMap.size); // 输出: 3
console.log(userMap.get('username')); // 输出: 'chen_lin'
console.log(userMap.has('role')); // 输出: true

如果在初始化数组中包含了相同的键，后出现的项会直接覆盖先出现的项，但键在 Map 中的插入顺序以第一次出现的时间为准：

// 存在重复键时的覆盖表现
const configMap = new Map([
  ['env', 'development'],
  ['timeout', 3000],
  ['env', 'production'] // 覆盖前面的 'development'
]);

console.log(configMap.get('env')); // 输出: 'production'
console.log(Array.from(configMap.keys())); // 顺序依然是 ['env', 'timeout']

常用数据源的快速转换与初始化

在实际业务场景中，我们很少手写大段字面量二维数组，更多是将已有的普通对象（Plain Object）或列表数据（List）快速组织为 Map 结构以获得高效的哈希检索能力。

1. 将普通 JavaScript 对象转为 Map

通过 Object.entries() 方法，可以直接提取对象自身所有可枚举属性的 [key, value] 键值对数组，将其直接传给 new Map()：

const apiConfig = {
  endpoint: 'https://api.example.com',
  timeout: 5000,
  retry: 3
};

// 一行代码将普通对象转换为 Map
const configMap = new Map(Object.entries(apiConfig));

console.log(configMap.get('timeout')); // 5000

2. 将对象列表转换为基于 ID 的哈希检索 Map

后端接口经常返回实体数组。若需要频繁通过 id 查询某个对象，在数组上频繁调用 find() 的时间复杂度为 O(N)，转换为 Map 后可以降为 O(1)：

const userList = [
  { id: 'u_101', name: '张伟', department: '研发部' },
  { id: 'u_102', name: '李强', department: '运维部' },
  { id: 'u_103', name: '王敏', department: '产品部' }
];

// 使用 Array.prototype.map 构建二维键值对数组
const userMap = new Map(
  userList.map(user => [user.id, user])
);

// 快速 O(1) 检索
const target = userMap.get('u_102');
console.log(target.name); // 输出: '李强'

键为引用类型时的寻址机制与常见误区

传统普通对象（Object）的键只能是字符串或 Symbol。如果用对象作为对象的键，会被隐式调用 toString() 变成 "[object Object]"。而 Map 真正做到了允许任意类型作为键，包括普通对象、函数、数组乃至 DOM 节点。

在利用二维数组初始化含有对象键的 Map 时，必须特别注意键的比较规则：Map 内部采用 SameValueZero 算法判断键是否相等（类似于 ===，但认为 NaN 等于 NaN）。

// ❌ 错误示范：匿名对象作为键导致无法按原键查询
const faultyMap = new Map([
  [{ role: 'admin' }, '管理员权限包']
]);
console.log(faultyMap.get({ role: 'admin' })); // 输出: undefined

// ✔ 正确做法：必须持有对象键的变量引用
const adminKey = { role: 'admin' };
const editorKey = { role: 'editor' };

const permissionMap = new Map([
  [adminKey, '管理员权限包'],
  [editorKey, '编辑员权限包']
]);

console.log(permissionMap.get(adminKey)); // 输出: '管理员权限包'

边界条件、异常处理与执行效率

在使用二维数组初始化 Map 时，应了解如下边界情况与引擎处理规则：

• 子数组元素数量不足：如果子数组只有一个元素 ['onlyKey']，构造函数提取 entry[0] 作为键，由于 entry[1] 为 undefined，该键对应的值即为 undefined。
• 子数组元素数量超出：若子数组包含超过 2 个元素（如 ['k', 'v', 'extra']），构造函数只取索引 0 和 1，多余的元素会被直接忽略，不会抛出错误。
• 非可迭代入参：若传入 null 或 undefined，构造函数返回一个空的 Map；但若传入非可迭代对象（如纯数字或普通对象 new Map({ a: 1 })），会抛出 TypeError: object is not iterable。
• 性能与批量构建：相比于先创建空 Map 再通过 forEach 逐个执行 map.set()，使用 new Map(entries) 可以让现代 V8 引擎在底层做一次性预分配与连续内存迭代，执行速度更快且代码声明意图更加明确。

总结

通过二维数组初始化 JavaScript Map 是一种紧凑且高效的编写方式。掌握这一操作的核心要点可以概括为三点：

1. 数据格式满足 [[key1, val1], [key2, val2]]，其中 [0] 为键、[1] 为值。
2. 对象转换优先选用 Object.entries()，数组列表构建索引优先使用 list.map(item => [item.id, item])。
3. 若将对象或函数作为键，必须保留其变量引用，避免因堆内存引用不同而导致读取失效。