将一段嵌套多层 .then() 的 Promise 链式调用改写为 async/await，看似简单，实则容易踩坑。核心矛盾在于：既要保持原有执行顺序，又不能遗漏任何一个错误处理分支。下面直接给出干货，先说明哪些情况可以安全转换，再提供手动重写和工具辅助两种路径。

确认原始 Promise 链是否可安全转换

打开你的 JS 文件，找到目标 Promise 链——需要先满足几个硬性条件：所有 .then() 回调仅返回普通值或新 Promise，中间没有手动抛出异常，也没有混用 try/catch。如果链中某个 .catch() 被省略，并且后续 .then() 依赖前序成功结果，那就不能直接转换，需要先补充错误捕获。

还要检查是否存在嵌套 Promise，例如某个 .then() 内部又 new Promise(...)。这种结构需要先扁平化再转换，否则 await 会提前结束外层作用域，导致逻辑混乱。

手动重写核心结构

第一步：在原函数声明前添加 async 关键字，例如 function fetchData() → async function fetchData()。

第二步：将第一个 .then() 前的 Promise 调用改用 await 替代。举例：const res = await fetch('/api/user').then(...) 应改为 const res = await fetch('/api/user')。请注意，await 后面只能跟 Promise 实例，不能直接跟 .then() 链，否则会语法报错。

第三步：逐层拆解后续 .then()。每个 .then(callback) 变为 const next = await callback(prev)，其中 prev 是上一步 await 的返回值。如果 callback 是纯函数（不包含异步操作），直接赋值即可，无需加 await。

第四步：将原链末尾的 .catch(err => {...}) 整体迁移到 try/catch 块中——try 包裹所有 await 行，catch 接收最终错误。漏掉这一步，未捕获的异常会导致程序崩溃。

用 CodeGeex 辅助转换（VS Code 插件版）

如果你不想手动逐行修改，CodeGeex 可以大幅节省时间。方法一：选中整段 Promise 链，右键 → “Ask CodeGeex” → 输入提示词：“把这段 Promise 链改写为 async/await，保持错误处理完整，不要简化逻辑”。

方法二：在光标处按 Ctrl+I（Windows）或 Cmd+I（Mac）呼出内联提问框，粘贴模板提示词：

“请将下方代码转为 async/await 形式，要求：① 所有 .then() 拆成独立 await 行；② 原 .catch() 必须转为 try/catch 块包裹全部 await；③ 不改变变量名和业务逻辑；④ 如果某 .then() 返回的是同步值，不要加 await。”

方法三：在 CodeGeex Web 界面（codegeex.cn）新建对话，上传包含 Promise 链的 JS 片段，指定语言为 Ja vaScript，并追加约束：“输出结果必须能直接替换原代码，不引入新依赖，不修改函数签名”。

验证转换后行为一致性

改完之后，必须进行验证。在浏览器控制台或 Node.js 环境中，对转换前后的函数分别传入相同参数，观察三点：

• 成功路径的返回值是否一致？
• 模拟网络失败（例如 mock fetch reject）时，错误是否被正确捕获，message 是否相同？
• 多个 await 是否保持串行执行（而非意外并行）？

特别留意 await 表达式是否被错误地放在 if 条件或循环体内导致跳过——CodeGeex 有时会将条件分支里的 .then() 全部提前 await，破坏逻辑分支隔离。

最后，设置一次 debugger; 断点，单步进入转换后的代码，逐一确认每一步的 resolve 值与原链中对应 .then() 的入参完全一致。这一过程虽然繁琐，但能够彻底杜绝隐性问题。