Node.js中rmDir、rmDirSync与rmSync的区别及用法咨询

1. 核心差异：异步 vs 同步 #

先搞懂最基础的异步/同步逻辑：

• 异步方法（rmDir）：后台执行删除操作，不会卡住后续代码，适合不希望阻塞程序运行的场景。
• 同步方法（rmDirSync、rmSync）：必须等删除完成后才会继续执行下一行代码，代码逻辑更线性，但会阻塞主线程。

2. 各自用法&特点 #

rmDir（异步删除目录） #

这是Node.js早期的异步删除目录API，默认只能删空目录，Node.js 12+后加{ recursive: true }参数才能删非空目录。

两种写法：

// 回调式（旧写法）
const fs = require('fs');
fs.rmDir('./cache', (err) => {
  if (err) throw err;
  console.log('缓存目录已删除');
});

// Promise式（Node.js 10+推荐）
const fs = require('fs').promises;
async function clearCache() {
  try {
    await fs.rmDir('./cache', { recursive: true });
    console.log('缓存目录已删除');
  } catch (err) {
    console.error('删除失败:', err);
  }
}
clearCache();

rmDirSync（同步删除目录） #

是rmDir的同步版本，逻辑和异步版完全一致，只是会阻塞主线程。同样默认删空目录，需加recursive: true删非空：

const fs = require('fs');
try {
  fs.rmDirSync('./cache', { recursive: true });
  console.log('缓存目录已删除');
} catch (err) {
  console.error('删除失败:', err);
}

rmSync（同步删除，Node.js 14+新增） #

这是官方推出的统一删除API，功能比rmDirSync强大得多：

• 既可以删目录（不管空不空），也能直接删单个文件，相当于整合了rmDirSync和unlinkSync的功能。
• 支持force: true参数：如果目录不存在，不会抛出错误，省去了额外判断目录是否存在的代码。

示例：

const fs = require('fs');
try {
  fs.rmSync('./cache', { recursive: true, force: true });
  console.log('缓存目录已删除');
} catch (err) {
  console.error('删除失败:', err);
}

3. 为什么更推荐rmSync而非rmDir？ #

主要有三个原因：

• 功能更全面：不用再区分是删文件还是目录，也不用纠结目录空不空，一个方法搞定。
• 代码更简洁：force参数省去了手动判断目录是否存在的冗余代码。
• 官方趋势：Node.js官方正在逐步推广rm（异步）和rmSync作为统一的删除工具，rmDir属于历史遗留API，新代码用rm/rmSync更符合未来的维护方向。

4. 你该怎么选？ #

你的场景是清理缓存，结合你的try-catch写法，给你两个判断维度：

• 如果是一次性脚本（比如启动前清理缓存的脚本，跑完就结束）：直接换rmSync，代码逻辑更简单，不用处理异步的Promise或回调，出错直接在try-catch里捕获，完全没问题。
• 如果是长期运行的服务（比如Node.js服务器里的定时清理）：别用同步方法，换成异步的fs.promises.rm，避免阻塞主线程影响服务响应。

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