fs 模块

前端贾公子

已于 2023-03-20 09:22:16 修改

阅读量1.6k

点赞数

分类专栏： node&&ts 文章标签：前端 javascript vue.js Powered by 金山文档

于 2023-03-17 17:47:29 首次发布

本文链接：https://blog.csdn.net/qq_63358859/article/details/129613996

版权

node&&ts 专栏收录该内容

26 篇文章 1 订阅

订阅专栏

fs 全称为 file system ，称之为文件系统，是 Node.js 中的内置模块，可以对计算机中的磁盘进行操作。

本章节会介绍如下几个操作：

1. 文件写入

2. 文件读取

3. 文件移动与重命名

4. 文件删除

5. 文件夹操作

6. 查看资源状态

一、文件写入

文件写入就是将数据保存到文件中，我们可以使用如下几个方法来实现该效果

1-1. writeFile 异步写入

语法：

fs.writeFile(file, data[, options], callback)

参数说明：

file 文件名

data 待写入的数据

options 选项设置（可选）

callback 写入回调

返回值： undefined

//导入fs模块
const fs = require('fs')
//写入文件
fs.writeFile('./座右铭.txt', '三人行，必有我师焉', err => {
    //如果写入失败，则回调函数调用时，会传入错误对象，如写入成功，会传入 null
    if (err) {
        console.log('写入失败');
        return
    }
})

1-2. writeFileSync 同步写入

语法: fs.writeFileSync(file, data[, options])

参数与 fs.writeFile 大体一致，只是没有 callback 参数

返回值： undefined

//导入fs模块
const fs = require('fs')
try {
    fs.writeFileSync('./data.txt', 'text')
} catch (error) {
    console.log(error);
}

Node.js 中的磁盘操作是由其他线程完成的，结果的处理有两种模式：
同步处理 JavaScript 主线程会等待其他线程的执行结果，然后再继续执行主线程的代码，
效率较低
异步处理 JavaScript 主线程不会等待其他线程的执行结果，直接执行后续的主线程代码，
效率较好

1-3. appendFile / appendFileSync 追加写入

appendFile 作用是在文件尾部追加内容，appendFile 语法与 writeFile 语法完全相同

语法:

fs.appendFile(file, data[, options], callback)

fs.appendFileSync(file, data[, options])

返回值：二者都为 undefined

//导入fs模块
const fs = require('fs')

fs.appendFile('./座右铭.txt', ',择其善者而从之，其不善者而改之', err => {
    if (err) {
        console.log('写入失败');
        return
    }
    console.log('写入成功');
})
fs.appendFileSync('./座右铭.txt', '\r\n温故而知新, 可以为师矣');

1-4. createWriteStream 流式写入

语法：

fs.createWriteStream(path[, options])

参数说明：

path 文件路径

options 选项配置（可选）

返回值： Object

//导入fs模块
const fs = require('fs')
// 创建写入流对象
let ws = fs.createWriteStream('./观书有感.txt');
ws.write('半亩方塘一鉴开\r\n');
ws.write('天光云影共徘徊\r\n');
ws.write('问渠那得清如许\r\n');
ws.write('为有源头活水来\r\n');
// 关闭通道
ws.close();

程序打开一个文件是需要消耗资源的，流式写入可以减少打开关闭文件的次数。
流式写入方式适用于大文件写入或者频繁写入的场景, writeFile 适合于写入频率较低的场景

1-5 写入文件的场景

文件写入在计算机中是一个非常常见的操作，下面的场景都用到了文件写入

下载文件

安装软件

保存程序日志，如 Git

编辑器保存文件

视频录制

当需要持久化保存数据的时候，应该想到文件写入

二、文件读取

文件读取顾名思义，就是通过程序从文件中取出其中的数据，我们可以使用如下几种方式：

2-1 readFile 异步读取

语法： fs.readFile(path[, options], callback)

参数说明：

path 文件路径

options 选项配置

callback 回调函数

返回值： undefined

//导入fs模块
const fs = require('fs')
fs.readFile('./观书有感.txt', (err, data) => {
    if (err) {
        console.log('读取失败');
        return
    }
    console.log(data.toString());
})

2-2 readFileSync 同步读取

语法： fs.readFileSync(path[, options])

参数说明：

path 文件路径

options 选项配置

返回值： string | Buffer


//导入fs模块
const fs = require('fs')

let data = fs.readFileSync('./座右铭.txt')
console.log(data.toString());

2-3 读取文件应用场景

电脑开机

程序运行

编辑器打开文件

查看图片

播放视频

播放音乐

Git 查看日志

上传文件

查看聊天记录

2-4 createReadStream 流式读取

语法： fs.createReadStream(path[, options])

参数说明：

path 文件路径

options 选项配置（可选）

返回值： Object


//导入fs模块
const fs = require('fs')
//创建读取流对象 
let rs = fs.createReadStream('./观书有感.txt');
//每次取出 64k 数据后执行一次 data 回调 
rs.on('data', data => {
    console.log(data);
    console.log(data.length);
});
//读取完毕后, 执行 end 回调 
rs.on('end', () => {
    console.log('读取完成')
})

三、文件移动与重命名

在 Node.js 中，我们可以使用 rename 或 renameSync 来移动或重命名文件或文件夹

语法：

fs.rename(oldPath, newPath, callback)
fs.renameSync(oldPath, newPath)

参数说明：

oldPath 文件当前的路径

newPath 文件新的路径

callback 操作后的回调

const fs = require('fs')
fs.rename('./观书有感.txt', './论语.txt', (err) => {
    if (err) {
        console.log('移动完成')
    }
    console.log('移动完成')
});
fs.renameSync('./座右铭.txt', './我的座右铭.txt');

四、文件删除

在 Node.js 中，我们可以使用 unlink 或 unlinkSync 来删除文件

语法：

fs.unlink(path, callback)

fs.unlinkSync(path)

参数说明：

path 文件路径

callback 操作后的回调


//导入fs模块
const fs = require('fs')
fs.unlink('./data.txt', err => {
    if (err) {
        console.log('删除失败');
    }
    console.log('删除成功');
})
fs.unlinkSync('./test2.txt');

五、文件夹操作

借助 Node.js 的能力，我们可以对文件夹进行创建、读取、删除等操作

5-1 mkdir 创建文件夹

在 Node.js 中，我们可以使用 mkdir 或 mkdirSync 来创建文件夹

语法：

fs.mkdir(path[, options], callback)

fs.mkdirSync(path[, options])

参数说明：

path 文件夹路径

options 选项配置（可选）

callback 操作后的回调


//导入fs模块
const fs = require('fs')
fs.mkdir('./html', err => {
    if (err) {
        console.log('失败');
    }
    console.log('成功');
})

fs.mkdir('./1/2/3', { recursive: true }, err => {
    if (err) throw err;
    console.log('递归创建成功');
});

5-2 readdir 读取文件夹

在 Node.js 中，我们可以使用 readdir 或 readdirSync 来读取文件夹

语法：

fs.readdir(path[, options], callback)
fs.readdirSync(path[, options])

参数说明：

path 文件夹路径

options 选项配置（可选）

callback 操作后的回调


//导入fs模块
const fs = require('fs')
fs.readdir('./', (err, data) => {
    if (err) {
        console.log('失败');
    }
    console.log('成功');
    console.log(data);
})

5-3 rmdir 删除文件夹

在 Node.js 中，我们可以使用 rmdir 或 rmdirSync 来删除文件夹

语法：

fs.rmdir(path[, options], callback)
fs.rmdirSync(path[, options])

参数说明：

path 文件夹路径

options 选项配置（可选）

callback 操作后的回调

//导入fs模块
const fs = require('fs')

fs.rmdir('./1', { recursive: true }, err => {
    if (err) throw err;
    console.log('递归删除成功');
});
fs.rmdir('./html', err => {
    if (err) throw err;
    console.log('删除成功');
});

六、查看资源状态

在 Node.js 中，我们可以使用 stat 或 statSync 来查看资源的详细信息

语法：

fs.stat(path[, options], callback)

fs.statSync(path[, options])

参数说明：

path 文件夹路径
options 选项配置（可选）
callback 操作后的回调

结果值对象结构：

size 文件体积

birthtime 创建时间

mtime 最后修改时间

isFile 检测是否为文件

isDirectory 检测是否为文件夹


//导入fs模块
const fs = require('fs')
fs.stat('./1.js', (err, data) => {
    if (err) {
        console.log('失败');
    }
    console.log(data);
    console.log(data.isFile());
    console.log(data.isDirectory());
})

七、相对路径问题

fs 模块对资源进行操作时，路径的写法有两种：

相对路径

./座右铭.txt 当前目录下的座右铭.txt

座右铭.txt 等效于上面的写法

../座右铭.txt 当前目录的上一级目录中的座右铭.txt

绝对路径

D:/Program Files windows 系统下的绝对路径

/usr/bin Linux 系统下的绝对路径

相对路径中所谓的当前目录，指的是命令行的工作目录，而并非是文件的所在目录
所以当命令行的工作目录与文件所在目录不一致时，会出现一些 BUG

八、__dirname

__dirname 与 require 类似，都是 Node.js 环境中的'全局'变量

__dirname 保存着当前文件所在目录的绝对路径，可以使用 __dirname 与文件名拼接成绝对路径

代码示例：

使用 fs 模块的时候，尽量使用 __dirname 将路径转化为绝对路径，这样可以避免相对路径产生的

Bug

path 模块

path 模块提供了操作路径的功能，我们将介绍如下几个较为常用的几个 API：

const path = require('path');
//获取路径分隔符
console.log(path.sep);
//拼接绝对路径
console.log(path.resolve(__dirname, 'test'));
//解析路径
let pathname = 'D:/programfile/nodejs/node.exe';
console.log(path.parse(pathname));
//获取路径基础名称
console.log(path.basename(pathname))
//获取路径的目录名
console.log(path.dirname(pathname));
//获取路径的扩展名
console.log(path.extname(pathname));

前端贾公子

关注

0
点赞
踩
5

收藏

觉得还不错? 一键收藏
0
评论
fs 模块

fs 全称为 file system ，称之为文件系统，是 Node.js 中的内置模块，可以对计算机中的磁盘进行操作。在 Node.js 中，我们可以使用 rename 或 renameSync 来移动或重命名文件或文件夹。在 Node.js 中，我们可以使用 stat 或 statSync 来查看资源的详细信息。在 Node.js 中，我们可以使用 unlink 或 unlinkSync 来删除文件。相对路径中所谓的当前目录，指的是命令行的工作目录，而并非是文件的所在目录。
复制链接

扫一扫