能安全重构为 async/await，但须跳过动态构造回调、eval、settimeout 字符串等场景；仅处理显式错误优先回调（如 fs.readfile、db.query），需满足「显式 callback 参数 + 确定性返回 promise」；强制转换需注释标记，替换时补全 try/catch 错误处理、包裹 awaitexpression、检查 this 绑定；promise 化依赖预声明（.promises 子模块或 promisify），且函数自身及调用链须同步升级为 async。

能安全重构，但必须跳过动态构造的回调、eval 内部、setTimeout 字符串参数等场景，否则生成的 async/await 会直接报错或逻辑错乱。

识别哪些回调嵌套可转为 await

不是所有带 callback 参数的函数调用都能改——关键看是否满足「显式回调参数 + 确定性返回 Promise」两个条件：

• 只处理形如 fs.readFile(path, cb)、db.query(sql, cb) 这类 Node.js 原生或约定俗成的错误优先回调（cb(err, result)）
• 跳过 setTimeout(fn, 100, arg)、array.forEach(cb)、element.addEventListener('click', cb) 这类非 I/O、无返回值、非错误优先结构的回调
• 若函数调用前有 /* @convert-to-async */ 注释，则强制纳入；若有 /* @no-convert */，则跳过整条语句
• 不处理 new Function(...) 或字符串形式的 setTimeout("...", 100)，AST 无法静态确认其回调结构

如何安全替换回调为 await 调用

不能简单把 fn(x, (err, res) => {...}) 换成 const res = await fn(x)，必须补全错误处理路径并保持作用域干净：

• 先用 @babel/types.t.tryStatement() 包裹原回调体，catch 分支提取 err 并 throw err，确保错误冒泡行为一致
• 用 t.awaitExpression(t.callExpression(...)) 构造 await 调用，不能漏掉 t.awaitExpression 外层包装，否则生成代码会丢掉 await 关键字
• 若原回调是箭头函数且用了 this，需检查父作用域是否为普通函数——async 函数不绑定 this，此时应拒绝转换并报 warning
• 替换后立即调用 path.stop()，防止子节点（如回调内的 if、return）被重复遍历误改

Promise 化函数必须提前声明或导入

重构后代码依赖 fnAsync 形式的封装函数（如 fs.promises.readFile），不能指望 AST 自动生成：

• 对 Node.js 内置模块（fs、dns、crypto），自动替换为对应 .promises 子模块，如 fs.readFile → fs.promises.readFile
• 对自定义函数（如 api.login(user, cb)），需检查是否已存在同名 api.loginAsync 或 api.loginPromise，不存在则跳过，不插入 require 或 import
• 若目标文件顶部已有 const { promisify } = require('util')，且调用的是标准 Node 回调函数，可用 promisify(fn) 包装，但必须确保 promisify 调用本身在顶层作用域或函数开头，避免闭包污染

最容易被忽略的是：重构后的函数自身必须标记为 async，且其所有上层调用者也得同步升级——AST 工具只能改当前文件内节点，跨文件的调用链需靠 CI 阶段的依赖分析或人工 review 补全，否则会触发 UnhandledPromiseRejectionWarning。