del vs fs-extra vs remove vs rimraf
Node.js 文件删除方案深度对比
搜索包...
delfs-extraremoverimraf类似的npm包:

Node.js 文件删除方案深度对比

del、fs-extra、remove 和 rimraf 都是 Node.js 生态中用于删除文件或目录的工具，但它们的定位和维护状态截然不同。rimraf 是底层递归删除的标准实现，del 是基于 rimraf 的现代 Promise 封装，fs-extra 提供了增强版的文件系统 API（包含删除功能），而 remove 包已过时不再推荐使用。

npm下载趋势

3 年

GitHub Stars 排名

统计详情

npm包名称
下载量
Stars
大小
Issues
发布时间
License
del01,34612.7 kB178 个月前MIT
fs-extra09,61257.7 kB132 个月前MIT
remove011-314 年前MIT
rimraf05,842262 kB83 个月前BlueOak-1.0.0

Node.js 文件删除方案深度对比

在 Node.js 开发中，清理构建产物、重置临时目录或删除旧日志是常见需求。虽然原生 fs 模块提供了 unlink 和 rmdir，但处理递归删除和通配符匹配非常麻烦。del、fs-extra、remove 和 rimraf 试图解决这些问题，但它们的实现方式和适用场景有很大区别。

🛠️ API 设计风格：回调 vs Promise vs Async

不同的包采用了不同的异步处理模式，这直接影响代码的可读性和维护成本。

del 基于 Promise 设计，天然支持 async/await，符合现代 JavaScript 标准。

// del: 原生 Promise 支持
import { deleteAsync } from 'del';

await deleteAsync(['dist/*.js', 'dist/*.css']);
// 返回已删除路径的数组

fs-extra 同时提供回调和 Promise 风格，API 与原生 fs 模块高度一致。

// fs-extra: 支持 Promise 和 Callback
import fs from 'fs-extra';

// Promise 风格
await fs.remove('dist');

// 回调风格
fs.remove('dist', err => { /*...*/ });

rimraf 早期版本主要基于回调，v5+ 版本转向 ESM 和 Promise，但底层逻辑依然保持简洁。

// rimraf: 现代版本支持 Promise
import { rimraf } from 'rimraf';

await rimraf('dist');
// 专注于递归删除，不返回复杂结果

remove 包采用老旧的回调模式，不支持 Promise，需要手动封装才能在现代代码中使用。

// remove: 仅支持回调 (已过时)
import remove from 'remove';

remove('dist', function (err) {
  if (err) throw err;
  console.log('deleted');
});

🌍 通配符支持：原生 vs 扩展

处理批量文件删除时，是否支持 Glob 模式（如 *.js）是关键差异点。

del 内置了 globby，直接支持通配符匹配，无需额外配置。

// del: 内置 Glob 支持
await deleteAsync(['tmp/**/*.log', '!tmp/important.log']);
// 支持排除模式，非常灵活

rimraf 支持简单的通配符，但主要设计用于删除单个路径或简单模式。

// rimraf: 基础 Glob 支持
await rimraf('tmp/*.log');
// 复杂模式可能需要配合 glob 包使用

fs-extra 本身不支持通配符，需要配合 glob 包手动实现。

// fs-extra: 需配合 glob 使用
import glob from 'glob';
import fs from 'fs-extra';

const files = await glob('tmp/*.log');
await Promise.all(files.map(f => fs.remove(f)));

remove 不支持通配符，只能删除指定路径的文件或目录。

// remove: 无 Glob 支持
remove('tmp/file.log', cb);
// 批量删除需要自己写循环

⚠️ 维护状态与风险提示

选择库时，维护状态直接关系到项目的长期安全和技术债务。

remove 包已经多年未更新，社区普遍认为它已过时。它的功能完全被 fs-extra 的 remove 方法覆盖。在新项目中引入它是一个明显的技术债务信号。

rimraf 是行业标准，被无数核心工具依赖。虽然 API 简单，但非常稳定。注意 v5 版本之后仅支持 ESM 模块。

del 保持活跃更新，专门针对前端构建场景优化。它处理了 Windows 路径锁定等边缘情况，比直接调用 rimraf 更省心。

fs-extra 是文件系统操作的瑞士军刀，维护非常积极。如果你的项目已经用它来做 copy 或 move，那么用它来做 remove 是自然的选择。

📦 实际场景推荐

场景 1：构建脚本清理

你需要在构建前清理 dist 目录，并删除所有临时日志。

  • ✅ 最佳选择：del
  • 原因：通配符支持好，API 简洁，专门为此场景设计。
// 构建脚本示例
import { deleteAsync } from 'del';
await deleteAsync(['dist', 'tmp/*.log']);

场景 2：通用文件工具库

你正在编写一个内部工具库，需要统一的文件操作 API。

  • ✅ 最佳选择：fs-extra
  • 原因：API 统一，减少依赖数量，文档完善。
// 工具库示例
import fs from 'fs-extra';
await fs.remove('/tmp/cache');

场景 3：底层 CLI 工具

你正在开发一个需要极致兼容性的命令行工具。

  • ✅ 最佳选择：rimraf
  • 原因：依赖最少，社区信任度高，行为可预测。
// CLI 工具示例
import { rimraf } from 'rimraf';
await rimraf(process.argv[2]);

场景 4：遗留项目维护

你正在维护一个 5 年前的老项目。

  • ⚠️ 注意：如果看到 remove 包，建议计划迁移到 fs-extra。
  • 原因：避免未来 Node.js 版本升级导致的兼容性问题。

📊 总结对比表

特性delfs-extrarimrafremove
异步模式PromisePromise / CallbackPromise / CallbackCallback
Glob 支持✅ 内置❌ 需配合 glob⚠️ 基础支持❌ 无
维护状态🟢 活跃🟢 活跃🟢 活跃🔴 过时
主要用途构建清理通用文件操作底层递归删除已淘汰
模块类型ESMCJS / ESMESM (v5+)CJS

💡 核心建议

del 是前端构建任务的首选 🧹 — 它解决了通配符和 Promise 的痛点，让清理代码变得非常干净。

fs-extra 是通用文件操作的最佳拍伴 🤝 — 如果你已经在使用它，就不要引入额外的删除库，保持一致性更重要。

rimraf 是底层实现的基石 🪨 — 当你需要最纯粹的递归删除功能，或者作为库的依赖时，它是最可靠的选择。

remove 包应该被移除 🗑️ — 它不再符合现代开发标准，迁移成本很低，但收益很高。

最终建议：在现代前端工程中，优先使用 del 处理构建清理，使用 fs-extra 处理应用内的文件操作。避免引入过时的 remove 包，除非你正在维护无法修改的遗留代码。

如何选择: del vs fs-extra vs remove vs rimraf

  • del:

    选择 del 如果你正在编写构建脚本或需要处理通配符模式（如 dist/*.js）。它基于 Promise，支持异步操作，并且默认忽略不存在的文件，非常适合现代前端工作流。

  • fs-extra:

    选择 fs-extra 如果你的项目已经依赖它来处理其他文件操作（如拷贝、移动）。它的 remove 方法 API 一致性好，支持同步和异步，且维护活跃。

  • remove:

    不要在新技术栈中使用 remove 包。它已多年未更新，缺乏 Promise 支持，且功能已被 fs-extra 和 rimraf 完全覆盖，存在维护风险。

  • rimraf:

    选择 rimraf 如果你需要最底层的递归删除能力，或者在编写 CLI 工具。它是许多其他工具（包括 del）的底层依赖，兼容性极强，但 API 相对基础。

与del类似的npm包

del 是一个用于删除文件和目录的 Node.js 库。它提供了一种简单而强大的方法来清理文件系统，支持删除文件、目录及其内容，并且可以使用 glob 模式来选择要删除的文件。虽然 del 提供了强大的删除功能，但在 Node.js 生态系统中还有其他一些库可以作为替代方案。以下是几个替代库：

  • fs-extra 是一个扩展了 Node.js 原生 fs 模块的库，提供了额外的文件系统方法。它不仅支持文件和目录的删除，还包括复制、移动、读取和写入等功能。fs-extra 旨在提供一个更丰富的 API，使文件操作变得更加简单和直观。如果你需要一个功能全面的文件系统库，fs-extra 是一个不错的选择。
  • rimraf 是一个简单的工具，用于递归删除文件和目录，类似于 UNIX 系统中的 rm -rf 命令。它非常轻量，专注于删除操作，适合需要快速删除大量文件和目录的场景。如果你只需要一个简单的删除工具，而不需要其他文件操作功能，rimraf 是一个理想的选择。

要查看 del 与 fs-extra 和 rimraf 的比较，请访问：比较 del vs fs-extra vs rimraf。

与fs-extra类似的npm包

fs-extra 是一个 Node.js 的文件系统扩展库，提供了许多额外的文件系统方法，使得文件操作更加简单和高效。它在 Node.js 的原生 fs 模块的基础上，增加了许多实用的功能，比如递归创建目录、复制文件和目录、删除文件和目录等。fs-extra 的 API 设计得非常直观，适合需要频繁进行文件操作的开发者。

在 fs-extra 之外，还有一些其他的替代库可以考虑：

  • fs 是 Node.js 的原生文件系统模块，提供了基本的文件操作功能，如读取、写入、删除文件等。虽然 fs 模块功能强大，但在处理一些复杂的文件操作时，可能需要编写更多的代码。对于简单的文件操作，fs 是一个不错的选择，但在需要更高效和简化的操作时，fs-extra 更为合适。
  • fs-extra-promise 是 fs-extra 的一个 Promise 版本，提供了与 fs-extra 相同的功能，但使用 Promise 进行异步操作。这使得在使用 async/await 语法时，处理文件操作变得更加方便。如果你的项目中已经在使用 Promise 或 async/await，fs-extra-promise 是一个理想的选择。

要查看 fs、fs-extra 和 fs-extra-promise 之间的比较，请访问：比较 fs vs fs-extra vs fs-extra-promise。

与remove类似的npm包

remove 是一个用于删除文件和目录的 npm 包。它提供了一种简单而有效的方式来处理文件系统中的删除操作。虽然 remove 提供了强大的删除功能，但在 Node.js 生态系统中还有其他一些库可以作为替代方案。以下是几个替代库：

  • del 是一个用于删除文件和目录的库，支持使用 glob 模式来匹配要删除的文件。它提供了一种简洁的 API，可以轻松地删除文件和目录，并且支持 Promise，使得异步操作变得更加简单。如果你需要根据模式删除多个文件，del 是一个很好的选择。
  • fs-extra 是一个扩展了 Node.js 原生 fs 模块的库，提供了额外的文件系统方法，包括删除文件和目录的功能。fs-extra 的 API 与原生 fs 模块相似，但增加了许多实用的功能，如递归删除目录、复制文件等。如果你需要一个功能全面的文件系统库，fs-extra 是一个不错的选择。
  • rimraf 是一个用于删除文件和目录的库，特别适用于删除不空的目录。它的功能类似于 Unix 中的 rm -rf 命令，能够强制删除目录及其内容。rimraf 是一个轻量级的库，适合需要强制删除目录的场景。

要查看 remove 与其他库的比较，请访问：比较 del vs fs-extra vs remove vs rimraf。

与rimraf类似的npm包

rimraf 是一个用于删除文件和目录的 Node.js 库，特别是用于递归删除。它是一个非常简单的工具，常用于构建和清理项目中的临时文件和目录。虽然 rimraf 提供了强大的删除功能，但在 Node.js 生态系统中还有其他一些库可以作为替代方案。以下是一些替代库：

  • del 是一个用于删除文件和目录的库，支持使用 glob 模式匹配文件。它提供了更高级的功能，例如可以在删除文件之前进行确认，并且支持 Promise API，使得在异步操作中使用更加方便。如果你需要更灵活的文件删除选项，del 是一个不错的选择。
  • fs-extra 是一个扩展了 Node.js 原生 fs 模块的库，提供了额外的文件系统方法，包括删除文件和目录的功能。fs-extra 的 API 设计与原生 fs 模块相似，因此如果你已经熟悉 fs 模块，使用 fs-extra 会非常自然。它还提供了许多其他有用的文件操作功能，使其成为一个多功能的文件系统库。
  • remove 是一个简单的库，用于删除文件和目录。它的设计目标是提供一个简单易用的 API，适合那些不需要复杂功能的用户。remove 适合小型项目或简单的文件删除需求，确保用户可以快速上手。

要查看 rimraf 与 del、fs-extra 和 remove 的比较，请访问：比较 del vs fs-extra vs remove vs rimraf。

del的README

del

Delete files and directories using globs

Similar to rimraf, but with a Promise API and support for multiple files and globbing. It also protects you against deleting the current working directory and above.

Install

npm install del

Usage

import {deleteAsync} from 'del';

const deletedFilePaths = await deleteAsync(['temp/*.js', '!temp/unicorn.js']);
const deletedDirectoryPaths = await deleteAsync(['temp', 'public']);

console.log('Deleted files:\n', deletedFilePaths.join('\n'));
console.log('\n\n');
console.log('Deleted directories:\n', deletedDirectoryPaths.join('\n'));

Beware

The glob pattern ** matches all children and the parent.

So this won't work:

deleteSync(['public/assets/**', '!public/assets/goat.png']);

You have to explicitly ignore the parent directories too:

deleteSync(['public/assets/**', '!public/assets', '!public/assets/goat.png']);

To delete all subdirectories inside public/, you can do:

deleteSync(['public/*/']);

Suggestions on how to improve this welcome!

API

Note that glob patterns can only contain forward-slashes, not backward-slashes. Windows file paths can use backward-slashes as long as the path does not contain any glob-like characters, otherwise use path.posix.join() instead of path.join().

deleteAsync(patterns, options?)

Returns Promise<string[]> with the deleted paths.

deleteSync(patterns, options?)

Returns string[] with the deleted paths.

patterns

Type: string | string[]

See the supported glob patterns.

options

Type: object

You can specify any of the globby options in addition to the below options. In contrast to the globby defaults, expandDirectories, onlyFiles, and followSymbolicLinks are false by default.

force

Type: boolean
Default: false

Allow deleting the current working directory and outside.

dryRun

Type: boolean
Default: false

See what would be deleted.

import {deleteAsync} from 'del';

const deletedPaths = await deleteAsync(['temp/*.js'], {dryRun: true});

console.log('Files and directories that would be deleted:\n', deletedPaths.join('\n'));
dot

Type: boolean
Default: false

Allow patterns to match files/folders that start with a period (.).

This option is passed through to fast-glob.

Note that an explicit dot in a portion of the pattern will always match dot files.

Example

directory/
├── .editorconfig
└── package.json

import {deleteSync} from 'del';

deleteSync('*', {dot: false});
//=> ['package.json']
deleteSync('*', {dot: true});
//=> ['.editorconfig', 'package.json']
concurrency

Type: number
Default: Infinity
Minimum: 1

Concurrency limit.

onProgress

Type: (progress: ProgressData) => void

Called after each file or directory is deleted.

import {deleteAsync} from 'del';

await deleteAsync(patterns, {
	onProgress: progress => {
	// …
}});
ProgressData
{
	totalCount: number,
	deletedCount: number,
	percent: number,
	path?: string
}
  • percent is a value between 0 and 1
  • path is the absolute path of the deleted file or directory. It will not be present if nothing was deleted.

CLI

See del-cli for a CLI for this module and trash-cli for a safe version that is suitable for running by hand.

Related

  • make-dir - Make a directory and its parents if needed
  • globby - User-friendly glob matching
npm-compare.com is an independent website designed to help developers choose the most suitable npm packages. We are not affiliated with npm, Inc, the official website for the npm registry. Note that npm is a registered trademark of npm, Inc. Please share your feedback via our GitHub repository. For more details, please refer to our Terms & Privacy.