map.prototype.foreach回调参数顺序是(value, key)，value在前key在后，与for...of解构[key, value]相反；常见错误是颠倒顺序导致类型判断失败或undefined访问。
Map.prototype.forEach 的回调函数参数顺序是 (value, key)，和数组的 forEach（item, index）不同，也和 for...of 解构写法（[key, value]）相反，容易混淆。
参数顺序必须牢记：value 在前，key 在后
Map 的 forEach 不接收“键值对对象”，而是直接传入两个独立参数：第一个是当前元素的值（value），第二个是它的键（key）。这与 Object.keys() 或普通对象遍历习惯相反，但设计上与 Set.prototype.forEach（只传 value）保持一致。
例如：
const map = new Map([['a', 1], ['b', 2], ['c', 3]]);
map.forEach((value, key) => {
console.log(key, value); // 输出：'a' 1，'b' 2，'c' 3
});
常见错误：把 key 和 value 位置写反
如果误写成 (key, value)，会导致逻辑出错，比如类型判断失败或访问 undefined：
-
typeof key === 'number'实际可能是字符串（因为本该是 value 的数字被当成了 key） -
value.toString()报错，因为真正的 value 其实是 key，可能为 Symbol 或 undefined - 调试时发现“键变成了数字，值变成了字符串”，大概率就是参数顺序颠倒了
对比其他遍历方式，加深理解
同一 Map，不同遍历写法的参数/结构差异明显：
-
forEach((v, k) => {...})→ v 是值，k 是键 -
for (const [k, v] of map)→ 解构顺序是 [key, value] -
map.entries()返回迭代器，每项是[key, value]数组
记住口诀：“forEach 值在前，for-of 键在前”。
实用建议：用解构 + 箭头函数提升可读性（可选）
如果更习惯“先 key 后 value”的语义，可以在回调内解构参数，不改变执行逻辑：
map.forEach((value, key) => {
const [k, v] = [key, value]; // 显式重命名，增强可读性
console.log(`${k}: ${v}`);
});
或者直接使用 for...of，语义更直观，尤其适合需要提前 break 或 await 的场景。
