Map.forEach 参数顺序为 value、key、map，与数组 forEach 的 item、index、array 位置相同但语义错位：数组的 index 对应 Map 的 key，而 value 与 item 虽同处第一位，但 Map 中键值分离，不可混用命名。

Map 的 forEach 参数顺序和数组的 forEach **并不一致**，这是最容易踩坑的地方。不能默认“都一样”，必须明确区分。

Map.forEach 的固定三元顺序：value、key、map

Map 的遍历逻辑围绕“值优先”设计：

• 第一个参数一定是 当前键对应的值（value）
• 第二个参数一定是 当前键（key）
• 第三个参数是 整个 Map 实例（map），可省略

哪怕你只写一个参数：myMap.forEach(v => console.log(v))，它拿到的也是 value，不是 key —— 这和数组 forEach(item => ...) 中的 item 是“元素本身”看似相似，但语义不同：数组的 item 就是值，而 Map 的“值”和“键”是分离的，必须靠位置识别。

数组 forEach 的标准三元顺序：item、index、array

数组方法中：

• 第一个参数是 当前元素（item）
• 第二个参数是 索引（index）
• 第三个参数是 原数组（array）

这个顺序在 Array.prototype.forEach、map、filter 等所有数组迭代方法中完全统一。但注意：它和 Map 的 (value, key, map) 仅有“三参数”形式上的相似，**实际含义和位置一一错位**——数组的 index 对应 Map 的 key，但一个在第二位，一个也在第二位；而数组没有“value/key”之分，所以不能凭“第几个参数”去类推。

为什么容易混淆？关键在命名习惯

很多人写 arr.forEach((key, value) => ...) 会报错或逻辑错乱，是因为下意识把数组写法套到 Map 上。反过来，写 myMap.forEach((item, index) => ...) 也会出问题——这里 item 实际是 value，index 实际是 key，类型和用途都可能不匹配。

安全做法是：

• Map 遍历时，**强制使用语义化变量名**：(value, key) 或 (val, k)，绝不使用 item/index 等数组术语
• 数组遍历时，**避免用 key/value**，尤其在处理对象数组时（如 users.forEach(({id, name}) => ...) 是解构，不是 Map 风格）
• 遇到不确定时，直接查文档或打印参数：myMap.forEach((a, b) => console.log('a=', a, 'b=', b))

对比速查表

（左列：参数位置｜右列：Map.forEach 含义｜中列：数组.forEach 含义）

① → value（值）｜ item（元素）
② → key（键）｜ index（索引）
③ → map（Map 实例）｜ array（原数组）

可见：仅第①位都代表“主要数据单元”，但第②位一个代表标识符（key），一个代表位置编号（index），本质不同。所谓“一致性”只存在于“都是三参数回调”，而非参数意义或用途。