async函数返回值总会被自动包装成Promise；await仅在async函数或模块顶层合法；await不阻塞线程，只暂停当前函数执行；错误需用try/catch捕获await表达式。
async 函数必须返回 Promise 吗？
不是必须显式 return new Promise()，但 async 函数的返回值总会被自动包装成 Promise。比如 async function foo() { return 42; } 实际等价于返回 Promise.resolve(42)；而 return Promise.reject(new Error('oops')) 会直接让调用方的 await 抛错。
常见错误：在 async 函数里忘记 await 一个 Promise，结果返回的是未等待的 Promise 对象本身，而不是它 resolve 的值。例如：
async function getData() {
fetch('/api/user') // ❌ 忘了 await，返回的是 Promise<Response>，不是 Response
}
正确写法是：
async function getData() {
const res = await fetch('/api/user') // ✅
return res.json()
}
await 只能在 async 函数里用吗？
是的，顶层 await（top-level await）只在模块作用域（.mjs 文件或 type="module" 的 script）中合法，在普通函数、循环、条件语句或非 async 函数内部直接写 await 都会报 SyntaxError: await is only valid in async functions and the top level modules。
立即学习“Java免费学习笔记（深入）”；
容易踩的坑：
- 在
for循环里想逐个 await，却误写成for (let i of arr) await doAsync(i)—— 这没问题，但若想并发执行，该用Promise.all(arr.map(...)) - 在箭头函数里写
() => await foo()，这非法；必须写成async () => await foo() - 试图在
try/catch外层 catch await 错误，但忘了 await 本身不抛异常，而是让 Promise reject，所以要用try/catch包住 await 表达式
await 会阻塞整个 JS 线程吗？
不会。await 只暂停当前 async 函数的执行，把控制权交还给事件循环，其余同步代码和微任务（如其他 Promise.then）照常运行。它不是“阻塞”，而是“暂停并让出”。
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
典型误解场景：
- 以为
await sleep(1000); console.log('done')会让后续所有 JS 停 1 秒 —— 实际只是这个函数的下一行延后执行，页面依然响应、定时器照走 - 用
await串行多个请求时，总耗时是各请求之和；若想缩短，得改用Promise.all([a(), b(), c()])并发发起 - Node.js 中 await 一个 fs.readFile 不会阻塞事件循环，但用
fs.readFileSync就会 —— 关键在底层 API 是否异步，不是 await 本身
如何处理 await 失败的情况？
最稳妥的方式是用 try/catch 捕获 await 表达式的 reject：
async function loadUser(id) {
try {
const res = await fetch(`/api/user/${id}`)
if (!res.ok) throw new Error(`HTTP ${res.status}`)
return await res.json()
} catch (err) {
console.error('Failed to load user:', err)
return null
}
}
注意：catch 捕获的是 Promise rejection，不是语法错误或同步异常（比如 JSON.parse(undefined) 仍会抛 SyntaxError）。另外，也可以用 .catch() 链式处理，但可读性差、错误堆栈更难追踪。
另一个实用技巧：封装一个不抛错的 await 辅助函数，比如：
async function safeAwait(promise) {
try {
return [null, await promise]
} catch (err) {
return [err, null]
}
}
// 用法：const [err, data] = await safeAwait(fetch('/api'))
实际项目中，并发请求多、错误路径复杂时，这种模式比层层 try/catch 更轻量——但别忘了，它掩盖了原始堆栈，调试时得留心。
真正麻烦的是嵌套异步逻辑里的错误传播边界，比如在 setTimeout 回调里 await，错误就彻底脱离外层 try/catch 了。这种地方，要么避免在非 async 上下文中启动 await，要么用 unhandledrejection 兜底监控。
