深入浅出fs-extra:Node.js文件操作的瑞士军刀

在Node.js的世界里,文件操作是日常开发不可或缺的一部分。虽然Node.js内置的fs(文件系统)模块提供了基本的文件读写能力,但在实际开发中,我们往往需要更多的功能和更简洁的API。这时候,fs-extra包就像是一把瑞士军刀,为我们提供了强大而便捷的文件操作工具。

1,为什么选择fs-extra?

fs-extra是对标准fs模块的扩展,它不仅包含了所有原生fs模块的方法,而且还添加了许多实用的功能,如复制、移动、删除文件/目录等。这些方法都支持Promise,使得我们可以用同步或异步的方式轻松处理文件。

其核心优势在于:

  • Promise 支持:所有方法都返回 Promise,便于使用 async/await 进行异步编程。
  • 简化路径处理:内置路径拼接、路径规范化等辅助函数。
  • 更丰富的 API:提供了一些 fs 没有的高级文件/目录操作方法。

2,快速上手

首先,确保你已经在项目中安装了fs-extra

js 复制代码
npm install fs-extra

安装完成后,就可以在你的项目中引入并使用它了。

文件复制

想要复制文件或目录,不必再手动创建目标路径,fs-extra让一切变得简单:

js 复制代码
const fse = require('fs-extra');

// 异步复制文件  
// '/path/to/source' 是源文件或目录的路径,而 '/path/to/dest' 是目标路径
fse.copy('/path/to/source', '/path/to/dest')
  .then(() => console.log('复制成功!'))
  .catch(err => console.error(err));

// 同步复制文件
try {
  fse.copySync('/path/to/source', '/path/to/dest');
  console.log('复制成功!');
} catch (err) {
  console.error(err);
}

文件移动

移动文件或目录也是一样的简单:

js 复制代码
// `'/path/to/source'` 是源文件或目录的路径,而 `'/path/to/dest'` 是目标路径
fse.move('/path/to/source', '/path/to/dest')
  .then(() => console.log('移动成功!'))
  .catch(err => console.error(err));

// 同步移动
try {
  fse.moveSync('/path/to/source', '/path/to/dest');
  console.log('移动成功!');
} catch (err) {
  console.error(err);
}

删除文件

使用fs-extra删除文件或目录,无需担心目录是否为空:

js 复制代码
// 异步删除
fse.remove('/path/to/dir')
  .then(() => console.log('删除成功!'))
  .catch(err => console.error(err));

// 同步删除
try {
  fse.removeSync('/path/to/dir');
  console.log('删除成功!');
} catch (err) {
  console.error(err);
}

读写JSON文件

处理JSON文件也变得异常简单:

js 复制代码
// 异步读取JSON文件
fse.readJson('/path/to/config.json')
  .then(config => {
    console.log(config);
  })
  .catch(err => console.error(err));

// 同步读取JSON文件
try {
  const config = fse.readJsonSync('/path/to/config.json');
  console.log(config);
} catch (err) {
  console.error(err);
}

// 异步写入JSON文件
fse.writeJson('/path/to/config.json', { name: 'fs-extra' })
  .then(() => console.log('写入成功!'))
  .catch(err => console.error(err));

// 同步写入JSON文件
try {
  fse.writeJsonSync('/path/to/config.json', { name: 'fs-extra' });
  console.log('写入成功!');
} catch (err) {
  console.error(err);
}

异步操作与Promise

fs-extra的所有异步方法都返回一个Promise,这意味着你可以使用async/await来处理更复杂的异步逻辑:

js 复制代码
const processFiles = async () => {
  try {
    await fse.copy('/path/to/source', '/path/to/dest');
    console.log('文件复制完成');
    const data = await fse.readJson('/path/to/config.json');
    console.log('配置读取完成', data);
    // ...更多异步操作
  } catch (err) {
    console.error('出错了', err);
  }
};

processFiles();

文件读写

  • readFile:读取文件内容。
javascript 复制代码
const data = await fse.readFile('./file.txt', 'utf8');
console.log(data);
  • writeFile:写入文件内容。
javascript 复制代码
await fse.writeFile('./file.txt', 'Hello, fs-extra!');
  • readJsonwriteJson:读写 JSON 文件。
javascript 复制代码
const config = await fse.readJson('./config.json');
console.log(config);

await fse.writeJson('./config.json', { key: 'value' }, { spaces: 2 });

目录操作

  • mkdirs (或 mkdirp):创建多级目录。
javascript 复制代码
await fse.mkdirs('./path/to/new/directory');
  • readdir:读取目录内容。
javascript 复制代码
const files = await fse.readdir('./directory');
console.log(files);
  • remove:删除文件或目录(递归删除)。
javascript 复制代码
await fs.remove('./directory');
  • ensureFileensureDir:确保文件或目录存在,如果不存在则创建。
javascript 复制代码
await fse.ensureFile('./path/to/new/file.txt');
await fse.ensureDir('./path/to/new/directory');
  • emptyDir:清空目录。
javascript 复制代码
await fse.emptyDir('./directory');

其他实用功能

  • path 属性:访问内置的 path 模块,用于路径相关操作。
javascript 复制代码
const filePath = fse.path.join('dir', 'file.txt');
  • createReadStreamcreateWriteStream:创建可读/可写流,适用于大文件操作。
javascript 复制代码
const readStream = fse.createReadStream('./large-file.bin');
const writeStream = fse.createWriteStream('./output.bin');

readStream.pipe(writeStream);

还有更多API可以参考官网

相关推荐
weixin-a153003083168 分钟前
【playwright篇】教程(十七)[html元素知识]
java·前端·html
ai小鬼头34 分钟前
AIStarter最新版怎么卸载AI项目?一键删除操作指南(附路径设置技巧)
前端·后端·github
一只叫煤球的猫1 小时前
普通程序员,从开发到管理岗,为什么我越升职越痛苦?
前端·后端·全栈
vvilkim1 小时前
Electron 自动更新机制详解:实现无缝应用升级
前端·javascript·electron
vvilkim1 小时前
Electron 应用中的内容安全策略 (CSP) 全面指南
前端·javascript·electron
aha-凯心2 小时前
vben 之 axios 封装
前端·javascript·学习
遗憾随她而去.2 小时前
uniapp 中使用路由导航守卫,进行登录鉴权
前端·uni-app
xjt_09012 小时前
浅析Web存储系统
前端
foxhuli2293 小时前
禁止ifrmare标签上的文件,实现自动下载功能,并且隐藏工具栏
前端
青皮桔3 小时前
CSS实现百分比水柱图
前端·css