Promisify 模式将“错误优先、回调结尾”的函数自动包装为返回 Promise 的函数，解决 Node.js 原生异步 API 嵌套深、错误处理冗余问题；其原理是 util.promisify 通过形参长度推断回调位置并注入标准 (err, result) 回调，仅适配严格遵循 Node 风格的函数。

理解 Promisify 模式，关键在于抓住一个核心转变：把“错误优先、回调结尾”的函数签名，自动包装成返回 Promise 的函数，从而让老代码自然融入 async/await 或 .then() 链中，不改逻辑，只换接口。

它解决的是什么问题

Node.js 原生模块（如 fs、child_process、dns）大量使用形如 fn(arg1, arg2, ..., callback) 的异步函数，其中 callback 必须是最后一个参数，且签名为 (err, result) => {}。这种写法在多步依赖时极易嵌套——比如先读文件，再执行命令，再写日志，层层缩进、错误重复判断、业务逻辑被切割得支离破碎。

Promisify 不是重写函数，而是提供一种“零侵入”的适配层：保留原有函数行为，仅改变调用方式和返回值类型。

用于自动切换项目中适合的node 版本

根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。

下载

它的基本原理很简单

Node.js 内置的 util.promisify 会检查传入函数的 length（形参个数），推断出回调参数位置；然后内部构造一个 Promise，在调用原函数时自动注入一个符合约定的回调：成功时 resolve(result)，失败时 reject(err)。

• 它只认标准 Node 回调风格：最后一个参数是函数，且该函数第一个参数是 err
• 不支持自定义回调名、不支持多回调、不支持事件式（如 on('data', ...)）接口
• 如果函数本身没有回调参数（比如已返回 Promise），promisify 会直接返回原函数

实际怎么用才顺手

推荐两种典型用法：

• 单个方法转换：适合少量调用或快速验证
  

  const { promisify } = require('node:util');<br>
    const execPromise = promisify(require('node:child_process').exec);<br>
    const { stdout } = await execPromise('ls -la');

• 整模块转换：适合高频使用某模块（如 fs）
  

  const fs = require('node:fs');<br>
    const { promisify } = require('node:util');<br>
    const readFile = promisify(fs.readFile);<br>
    const writeFile = promisify(fs.writeFile);

  
  或更简洁地：const fsPromises = require('node:fs').promises;（Node.js 10+ 原生支持）

注意几个常见误区

不是所有函数都能直接 promisify：

• 带上下文（this）绑定的函数需手动 .bind()，否则执行时 this 会丢失
• 某些第三方库的回调不严格遵循 (err, data) 约定（比如先 data 后 err），这时要用自定义 promisify 或改用 es6-promisify 等兼容性更强的库
• 不能用于同步函数（如 fs.readFileSync），也不应强行包装