Promise 构造函数必须显式调用 resolve 或 reject，否则永久 pending；需覆盖所有异步分支、加超时兜底；async/await 必须每处 await 配 try/catch；Promise.allSettled 替代 all 获取全量结果；.then 中必须显式 return 避免 undefined 传递。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Promise 构造函数里忘了
或
会卡死
Promise 不会自动结束，一旦构造函数执行完但没调用
或
，它就永远处于
状态。常见于异步操作没覆盖全分支，比如只处理了成功回调，漏了失败或超时。
检查所有可能的退出路径：网络请求的
、定时器的
后是否还有
、事件监听器里是否每个事件类型都对应了
/
加个兜底超时：
并在正常完成时
Node.
js
环境下可用
包装老式回调函数，避免手写 Promise 时遗漏
用
替代嵌套
但没加
让代码线性可读，但错误不会自动抛到外层——它只会让当前
函数返回一个 rejected Promise，不捕获就会静默失败或炸到未处理拒绝（
）。
每个
行都应处在
块中，尤其是调用外部 API、读文件、数据库查询
不要只在最外层包一层
：内部多个
中任意一个出错，都会跳到
，但你无法知道是哪一步挂了 —— 拆成小函数 + 单独处理更可控
浏览器中可通过监听
快速定位漏捕获点
遇到第一个失败就中断，但你要的是“全量结果”
是短路的，只要一个 Promise reject，整个就 reject，拿不到其他已完成的结果。这在并发请求聚合场景下很危险，比如批量上传文件，一个失败不该让其余结果丢失。
改用
（ES2020+），它总是返回所有 Promise 的状态数组，每个元素含
、
或
旧环境可用
手动兜底
注意
不提升性能，只是语义更安全；若需失败即停且不关心其余结果，
仍更合适
链式调用里忘了
，导致下一个
收到
这是最隐蔽的坑：在
回调里没显式
，后续的
就会拿到
，而不是你预期的数据。尤其在解构赋值、条件判断后容易漏。
豆包AI编程
豆包推出的AI编程助手
下载
立即进入
“
豆包AI人工智官网入口
”；
立即学习
“
豆包AI人工智能在线问答入口
”；
检查每个
回调的末尾：是不是写了
而不是只写了
？
箭头函数单行隐式返回易误判：
✅，但
❌（花括号块不自动返回）
用
规则
和
可提前暴露这类问题
Promise 的本质是状态机，不是语法糖。写的时候得时刻想清楚：这个 Promise 在什么条件下变成 fulfilled？什么条件下变成 rejected？有没有第三种可能被忽略？漏掉任何一个出口，就是线上 bug 的伏笔。
resolverejectresolverejectpendingcatchclearTimeoutrejectresolverejectconst timeout = setTimeout(() => reject(new Error('timeout')), 5000);clearTimeout(timeout)util.promisifyasync/await.then()try/catchasync/awaitasyncunhandledrejectionawaittry/catchtry/catchawaitcatchwindow.addEventListener('unhandledrejection')Promise.allPromise.allPromise.allSettledstatusvaluereasonPromise.all(promises.map(p => p.catch(e => ({ error: e })))).then(results => {...})Promise.allSettledPromise.allreturn.thenundefined.thenreturn.thenundefined.thenreturn fetch(...)fetch(...).then(x => x.data).then(x => { x.data })eslintno-return-awaitconsistent-return