JavaScript 中 map 是同步方法，不等待 await，需用 Promise.all 包裹其生成的 Promise 数组以并发获取解析值；错误写法是 map 内 await 后未 return，正确应返回 Promise 并配合 Promise.all；串行场景改用 for...of 或 reduce；可封装 asyncMap 工具函数提升复用性与可维护性。
在 JavaScript 中，map 是同步方法，它不会等待 await 表达式完成，所以直接在 map 回调里写 await，只会返回一堆 pending 状态的 Promise，而不是你想要的解析后的真实值。
用 Promise.all 包裹 map 生成的 Promise 数组
这是最常用也最推荐的方式：先用 map 创建 Promise 数组，再用 Promise.all 并发等待全部 resolve。
- 确保所有异步操作是独立、可并发执行的（比如多个 API 请求）
-
Promise.all会在任一 Promise reject 时立即失败，如需容错，考虑Promise.allSettled - 示例：const results = await Promise.all(urls.map(async url => fetch(url).then(r => r.json())));
避免在 map 内部直接 await 后“忘记 return”
常见错误是写了 await 却没显式 return，或 return 了未 await 的 Promise，导致外层拿到的是 Promise 而非值。
- 检查回调函数是否以
return结尾，且返回的是已 resolve 的值（不是 Promise） - 错误写法：arr.map(async item => { const res = await api(item); console.log(res); }) —— 没 return，结果全是
undefined - 正确写法：arr.map(async item => { const res = await api(item); return res; }) —— 返回 Promise，配合
Promise.all才有意义
需要串行执行？改用 for...of 或 reduce
如果逻辑必须按顺序执行（比如前一个请求结果影响后一个），map 不适用，应换同步迭代方式。
-
for...of最直观：逐个 await，天然串行 -
reduce可链式累积：适合有状态依赖的场景，例如累计 token 或构建上下文 - 示例（串行）：const results = []; for (const item of arr) { results.push(await api(item)); }
想保持语义清晰？封装成 asyncMap 工具函数
把模式固化，避免每次重复写 Promise.all + map，也方便统一处理错误或限流。
- 基础版：const asyncMap = async (arr, fn) => Promise.all(arr.map(fn));
- 增强版可加并发控制（如 p-limit）、失败重试、超时等能力
- 使用时语义明确：const data = await asyncMap(items, item => fetchItem(item));
