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 本身的状态管理机制，才是你绕不开的底层契约。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
