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），也不应强行包装
