Promise 是一个状态容器，初始为 pending，之后只能变为 fulfilled 或 rejected 且不可逆；它不是回调函数的语法糖，也不能让异步变同步。

Promise 是什么，不是什么

Promise 不是回调函数的语法糖，也不是让异步变同步的魔法。它是一个**状态容器**：初始为 pending，之后只能变成 fulfilled（成功）或 rejected（失败），且不可逆。理解这点，才能避免常见误用——比如在 then 里忘记返回新 Promise，导致后续链式调用接收到 undefined。

链式调用中 return 的值决定下一级的输入

这是最容易踩坑的地方。每个 then 的返回值，会作为下一个 then 的参数传入；若返回的是 Promise，则等待其 settle 后再继续；若返回普通值（如字符串、对象），则自动包装成 resolved 状态的 Promise。

fetch('/api/user')
  .then(res => res.json())
  .then(user => {
    console.log(user.name); // ✅ 正常取值
    return fetch(`/api/posts?uid=${user.id}`); // ✅ 返回 Promise，下一级等它完成
  })
  .then(res => res.json())
  .then(posts => console.log(posts.length)); // ✅ 接收到的是 posts 数组

常见错误：

• 在 then 里只做 console.log，不 return → 下一级收到 undefined
• 误以为 async/await 能“穿透” Promise 链 → 实际上 async 函数总是返回 Promise，必须显式 await 或 return

错误处理别只靠 catch 最后兜底

catch 只捕获它前面最近一个未被处理的 rejection。如果中间某步用了 catch 却没重新抛出，错误就“消失”了，后续 then 仍会执行。

Promise.resolve()
  .then(() => { throw new Error('step1') })
  .catch(err => console.log('caught:', err.message)) // ✅ 打印 'step1'
  .then(() => console.log('this still runs!')); // ✅ 会执行 —— 错误已被吞掉

正确做法：

• 在关键步骤后立即 catch 并决定是否重抛：catch(err => { handleError(err); throw err; })
• 用 finally 做清理（如关闭 loading 状态），但它不接收参数，也不影响链路状态
• 避免把所有逻辑塞进单个 then，拆分步骤才能精准定位失败点

并发控制：Promise.all、Promise.race 和 Promise.allSettled 的实际取舍

它们解决不同问题，不能混用：

• Promise.all：全部成功才 resolve，任一 reject 整体失败 → 适合“全有或全无”的场景（如批量提交表单）
• Promise.race：谁先 settle 就用谁的结果 → 适合超时控制：Promise.race([fetch(url), timeout(5000)])
• Promise.allSettled：不管成败都等全部结束，返回每个 Promise 的状态对象 → 适合日志上报、批量请求结果汇总

注意：Promise.all 在 Safari 12+ 以下不支持，需 polyfill 或降级为手动循环 + reduce。

真正难的不是写对一个 Promise，而是当流程嵌套三层以上、中间有分支条件（比如“用户有权限才请求详情”）、还要支持取消时，怎么让逻辑可读、可测、可维护。这时候，async/await 是语法糖，但 Promise 本身的状态管理机制，才是你绕不开的底层契约。