如何以async/await方式使用npm mv模块？或有何同类替代方案

咨询内容 #

本次咨询的核心问题有两个：

• 是否有可行方案，无需沿用mv模块官方文档给出的回调形式，直接通过async/await语法调用该模块实现文件移动
• npm生态下还有哪些模块可以实现同等的文件移动能力

官方文档给出的mv模块基础回调调用示例如下：

var mv = require('mv');

mv('source/file', 'dest/file', function(err) {
  ...
});

实现方法说明 #

适配async/await调用mv模块的方案 #

mv模块采用的是标准错误优先回调风格，不需要修改模块源码，仅通过轻量包装就可以转为可配合async/await使用的Promise形式，常见实现方式有两种：

• 基于Node.js内置util.promisify快速转换
  这是最简洁的原生适配方式，转换过程完全兼容原模块的所有参数配置，包括自动创建目标目录、文件冲突处理规则等选项，无额外逻辑损耗，示例代码：

  const mv = require('mv');
  const { promisify } = require('util');
  // 生成Promise版本的mv方法
  const mvPromise = promisify(mv);
  
  // async/await调用示例
  async function runMove() {
    try {
      // 原模块支持的配置项可作为第三个参数传入，和回调写法完全一致
      await mvPromise('source/file', 'dest/file', {
        mkdirp: true,
        clobber: false
      });
    } catch (err) {
      // 捕获移动全流程的错误
      console.error(err);
    }
  }
  

• 手动封装Promise包装器
  如果希望自定义调用逻辑（比如增加移动日志、失败重试等能力），可以手动编写少量封装代码实现同等效果，灵活性更高，示例代码：

  const mv = require('mv');
  function mvAsync(source, dest, options = {}) {
    return new Promise((resolve, reject) => {
      mv(source, dest, options, (err) => {
        if (err) {
          return reject(err);
        }
        resolve();
      });
    });
  }
  

可实现同等文件移动能力的替代npm模块 #

目前npm生态下可选的文件移动能力实现主要有以下几类：

• Node.js内置fs.promises.rename：零额外依赖，属于Node原生能力，适合单磁盘分区内的快速移动操作，跨磁盘分区移动时会触发系统层面的EXDEV错误，需要额外补充降级处理逻辑
• fs-extra：对原生fs模块的全能力扩展，提供原生Promise风格的move方法，内置跨磁盘移动、目标目录自动创建、冲突处理等全量能力，功能和mv模块对齐度极高，是当前社区的主流选择
• move-file：轻量专用文件移动模块，默认导出Promise接口，包体积小、无冗余依赖，支持自动创建目标目录、自定义覆盖规则等常用能力，适合对依赖体积敏感的场景

内容的提问来源于stack exchange，提问作者user_id