将 legacy 代码中的回调地狱重构为 async/await，核心是将回调函数封装为 Promise 对象，并在调用处使用 await 关键字串行执行。该方案适用于 Node.js 7.6+ 或支持 ES2017 标准的浏览器环境，主要风险在于错误处理机制从回调参数变为 try/catch 块。

快速处理思路

代码重构不涉及命令行操作，需按逻辑层级逐步替换。先备份原代码分支，确保有单元测试覆盖核心流程，再按依赖顺序从外层向内层重构，避免一次性全量修改导致回归困难。

为什么会这样

回调地狱导致代码嵌套过深，可读性和错误处理难度随层级增加而上升。async/await 基于 Promise 实现，允许异步代码以同步写法表达，引擎会自动处理状态流转，但底层仍是非阻塞机制。

分步处理

步骤 1：识别回调模式
适用场景：所有使用回调函数的 legacy 代码。
操作动作：查找函数签名中最后一个参数是否为 callback，确认是否遵循 (err, result) 格式。
风险边界：部分老旧库可能使用 (result, err) 或非标准回调，需单独适配。

步骤 2：封装 Promise
适用场景：自定义异步函数或无原生 Promise 支持的库。
操作动作：新建 Promise 实例，在回调成功时 resolve，失败时 reject。
配置片段：

function legacyFunc(arg, callback) {
  // 原有逻辑
}

function wrappedFunc(arg) {
  return new Promise((resolve, reject) => {
    legacyFunc(arg, (err, result) => {
      if (err) return reject(err);
      resolve(result);
    });
  });
}

验证结果：调用 wrappedFunc 返回 Promise 对象。

步骤 3：使用 async/await 调用
适用场景：已封装为 Promise 的函数调用处。
操作动作：将外层函数标记为 async，使用 await 等待结果。
配置片段：

async function main() {
  try {
    const res = await wrappedFunc('data');
    console.log(res);
  } catch (e) {
    console.error(e);
  }
}

风险边界：await 必须在 async 函数内部使用，顶层 await 需环境支持。

步骤 4：处理 Node.js 原生模块
适用场景：fs、dns 等 Node.js 核心模块。
操作动作：直接使用 util.promisify 无需手动封装。
配置片段：

const util = require('util');
const fs = require('fs');
const readFile = util.promisify(fs.readFile);

验证结果：readFile 返回 Promise，可直接 await。

怎么验证是否生效

运行原有单元测试套件，确认所有测试用例通过且无未捕获的 Promise rejection 警告。检查日志中是否仍有回调嵌套堆栈，确认错误堆栈信息包含 async 帧而非纯回调帧。在开发环境开启 `--trace-warnings` 参数，观察是否有未处理的异步错误。

常见坑

1. 遗漏 await：在 async 函数中调用 Promise 但未加 await，导致代码未等待执行完成即继续，适用场景为并行任务，否则需补全 await。
2. 混合风格：同一函数内混用回调和 await，导致执行顺序不可控，建议统一为 Promise 风格。
3. 错误吞没：未在 async 函数外包裹 try/catch，导致错误变为未处理的 rejection，风险边界是进程可能意外退出。

常见问题

async/await 会影响性能吗？

公开资料中没有看到可靠的量化数据表明 async/await 比纯 Promise 链式调用有显著性能差异，主要开销在于微任务队列调度，通常可忽略。

旧版 Node.js 不支持怎么办？

Node.js 7.6 以下版本不支持 async/await，建议升级运行时或使用 Babel 转译代码，但生产环境推荐升级 Node.js LTS 版本。

如何并行执行多个 await 任务？

使用 Promise.all 包裹多个 await 调用，避免串行等待，例如 const results = await Promise.all([task1(), task2()])。

参考来源

• MDN Web Docs, async function, https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Statements/async_function
• MDN Web Docs, await, https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Operators/await
• Node.js Documentation, util.promisify, https://nodejs.org/api/util.html#utilpromisifyoriginal