async/await 是 Promise 的语法糖,不改变异步本质;需并行用 Promise.all、防错用 try/catch、循环慎用 await、返回值必为 Promise。

async/await 不是“写起来像同步,就真当同步用”的语法糖。它简化了 Promise 的调用形式,但执行逻辑、错误传播、并发控制依然严格遵循 Promise 和事件循环规则。防坑的关键,在于理解它“暂停的是函数体,不是线程”,以及“每个 await 都是一次潜在的异常出口”。
别把独立请求写成串行链
多个不依赖彼此的异步操作(比如同时拉用户信息、配置项、通知未读数),如果逐个 await,耗时是总和;而用 Promise.all 并行发起,耗时取决于最慢那个。
- ❌ 错误写法:顺序等待,阻塞后续请求
const user = await fetchUser();
const config = await fetchConfig();
const notices = await fetchNotices();
- ✅ 正确写法:并行触发,解构获取结果
const [user, config, notices] = await Promise.all([
fetchUser(),
fetchConfig(),
fetchNotices()
]);
注意:Promise.all 会因任一失败而整体 reject。如需“部分失败仍得结果”,改用 Promise.allSettled。
每个 await 都要配错误边界
await 后的 Promise 一旦 rejected,会直接抛出错误,中断后续代码——若没被 try/catch 捕获,就会变成未处理的 promise rejection,控制台报错且可能静默失败。
- 必须对每个可能失败的 await 做防御,尤其 fetch、JSON 解析、第三方 SDK 调用
- 推荐结构:外层 try/catch 包裹整段逻辑,内部可按需细分错误类型(如网络错误 vs 业务错误)
try {
const res = await fetch('/api/profile');
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
return data;
} catch (err) {
console.warn('加载个人资料失败:', err.message);
return { name: '游客', avatar: '/default.png' }; // 提供降级数据
}
使用约定式提交(Conventional Commits)生成标准化的 Git 提交信息。适用于以下场景: (1) 暂存更改时需要提交信息; (2) 审查 diff 时希望获得结构化摘要; (3) 编写 PR 描述或变更日志(changelog)条目; (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff,并生成按类型(type)划分范围的提交信息。
别在循环里无脑 await
for 循环中直接 await,本质仍是串行执行。除非任务之间有强依赖(如“上一条上传成功后才传下一条”),否则性能极差。
- ✅ 多个独立任务:先 map 成 Promise 数组,再 Promise.all
- ✅ 需要控制并发数量(如同时最多 3 个请求):用 p-limit 等工具封装
- ✅ 有依赖关系的任务链:才用 for + await(例如分页拉取,后一页依赖前一页的 cursor)
示例(并行上传多张图片):
const uploadPromises = files.map(file => uploadFile(file));
const results = await Promise.all(uploadPromises);
清楚 async 函数的返回值本质
async 函数无论 return 什么,外部拿到的永远是一个 Promise。忘记这点,容易写出 const data = myAsyncFn() 这类错误用法——data 是 Promise,不是实际数据。
- 调用 async 函数后,要么 await 它(在另一个 async 函数内),要么用 .then() 处理
- 不要混用:不在 async 函数里 await,又不接 .then —— 数据就“掉进黑洞”了
反例:
function init() {
getData(); // 忘记处理返回的 Promise
renderUI(); // 此时 getData 还没完成,UI 渲染为空
}
正解:
async function init() {
const data = await getData();
renderUI(data);
}










