NodeJs-fs模块

一、fs简介

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

主要介绍如下几个操作:

  1. 文件写入
  2. 文件读取
  3. 文件移动与重命名
  4. 文件删除
  5. 文件夹操作
  6. 查看资源状态

二、文件写入

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

方法 说明
writeFile 异步写入
writeFileSync 同步写入
appendFile /appendFileSync 追加写入
createWriteStream 流式写入

2.1 writeFile 异步写入

语法: fs.writeFile(file, data[, options], callback)
参数说明:

  • file 文件名
  • data 待写入的数据
  • options 选项设置 (可选)
  • callback 写入回调

返回值: undefined

代码示例:

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

//2.写入文件(writeFile异步写入)
fs.writeFile('./file/writeFile.txt','三人行,则必有我师焉',err=>{
    
    
    //如果写入失败,则回调函数调用时,会传入错误对象,如写入成功,会传入 null
    if(err){
    
    
        console.log('写入失败');
        return
    }
    console.log('写入成功');
})

2.2 writeFileSync 同步写入

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

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

返回值: undefined

代码示例:

//写入文件,writeFileSync同步写入,没用回调函数
try {
    
    
    fs.writeFileSync('./file/writeFileSync.txt','你好啊世界');
} catch (error) {
    
    
    console.log(error);
}

Node.js 中的磁盘操作是由其他 线程 完成的,结果的处理有两种模式:

  • 同步处理 JavaScript 主线程 会等待 其他线程的执行结果,然后再继续执行主线程的代码,效率较低
  • 异步处理 JavaScript 主线程 不会等待 其他线程的执行结果,直接执行后续的主线程代码,效率较好

2.3 appendFile / appendFileSync 追加写入

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

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

返回值: 二者都为 undefined

实例代码:

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

// 2.appendFile异步追加写入
fs.appendFile('./file/appendFile.txt','异步追加写入,nodejs',err=>{
    
    
    if(err) throw err;
    console.log('异步追加成功');
})
console.log(1);

//3.appendFileSync同步追加写入
fs.appendFileSync('./file/appendFileSync.txt','同步追加写入,nodejs');

//4.writeFile实现追加写入
fs.writeFile('./file/writeFile.txt',',love love',{
    
    flag:'a'},err=>{
    
    
    if(err) throw err;
    console.log('异步追加成功');
})

2.4 createWriteStream 流式写入

语法: fs.createWriteStream(path[, options])
参数说明:

  • path 文件路径
  • options 选项配置( 可选 )

返回值: Object
代码示例:

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

//2.创建写入流对象
const ws = fs.createWriteStream('./file/stream.txt');

//3.write写入
ws.write('你好啊')
ws.write('手机接')

//4.关闭通道
ws.close();

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


三、文件读取

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

方法 说明
readFile 异步读取
readFileSync 同步读取
createReadStream 流式读取

3.1 readFile 异步读取

语法: fs.readFile(path[, options], callback)
参数说明:

  • path 文件路径
  • options 选项配置
  • callback 回调函数

返回值: undefined
代码示例:

//1.引入fs模块
const fs = require('fs');

//2.异步读取
fs.readFile('./file/appendFile.txt','utf-8',(err,data)=>{
    
    
    if(err){
    
    
        console.log("读取失败");
        return;
    }
    console.log(data.toString());
})

3.2 readFileSync 同步读取

语法: fs.readFileSync(path[, options])
参数说明:

  • path 文件路径
  • options 选项配置

返回值: string | Buffer
代码示例:

let data = fs.readFileSync('./座右铭.txt');
let data2 = fs.readFileSync('./座右铭.txt', 'utf-8');

3.3 createReadStream 流式读取

语法: fs.createReadStream(path[, options])
参数说明:

  • path 文件路径
  • options 选项配置

返回值: Object
代码示例:

//1.创建fs模块
const fs = require('fs');

//2.流式读取
const rs = fs.createReadStream('./file/appendFile.txt');

//3.每次取出 64k 数据只执行一次 data 回调
rs.on('data',data=>{
    
    
    console.log(data.toString())
})

//4.读取完毕后, 执行 end 回调
rs.on('end',()=>{
    
    
    console.log('读取完成');
})

四、文件移动与重命名

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

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

参数说明:

  • oldPath 文件当前的路径
  • newPath 文件新的路径
  • callback 操作后的回调

代码示例:

//1.引入fs模块
const fs = require('fs');
// 2.文件重命名rename renameSync(同步)
fs.rename('./file/test.txt','./file/hello.txt',err=>{
    
    
    if(err){
    
    
        console.log(err);
        return;
    }
    console.log('操作成功');
})

//3.文件移动
fs.renameSync('./file/hello.txt','./hello.txt');

五、文件删除

在 Node.js 中,我们可以使用 unlink 或 unlinkSync 来删除文件
语法:

  • fs.unlink(path, callback)
  • fs.unlinkSync(path)

参数说明:

  • path 文件路径
  • callback 操作后的回调

代码示例:

//1.引入fs模块
const fs = require('fs');

//2.可以使用 unlink 或 unlinkSync 来删除文件
fs.unlink('./file/test.txt',err=>{
    
    
    if(err){
    
    
        console.log(err);
        return;
    }
    console.log('删除成功');
})

//fs.unlinkSync('./test2.txt');


//3.还可以调用14.4版本新出的rm和rmSync来删除文件
fs.rm('./file/test.txt',err=>{
    
    
    if(err){
    
    
        console.log(err);
        return;
    }
    console.log('删除成功');
})

六、文件夹操作

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

方法 说明
mkdir / mkdirSync 创建文件夹
readdir / readdirSync 读取文件夹
rmdir / rmdirSync 删除文件夹

6.1 mkdir创建文件夹

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

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

参数说明:

  • path 文件夹路径
  • options 选项配置( 可选 )
  • callback 操作后的回调

示例代码:

//1.引入fs模块
const fs = require('fs');

//2.可以使用 mkdir 或 mkdirSync 来创建文件夹
fs.mkdir('./file',err=>{
    
    
     if(err) return;
     console.log('创建成功');
 })

//递归异步创建
fs.mkdir('./a/b/c',{
    
    recursive:true},err=>{
    
    
    if(err) return;
    console.log('创建成功');   
})

//递归同步创建
fs.mkdirSync('./c/b/a',{
    
    recursive:true});

6.2 readdir 读取文件夹

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

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

参数说明:

  • path 文件夹路径
  • options 选项配置( 可选 )
  • callback 操作后的回调

示例代码:

//1.引入fs模块
const fs = require('fs');
//2.可以使用 readdir 或 readdirSync 来读取文件夹
fs.readdir('./file',(err,data)=>{
    
    
    if(err) return;
    console.log(data);
})
//3.同步读取
let data = fs.readdirSync('./file');
console.log(data);

6.3 rmdir 删除文件夹

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

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

参数说明:

  • path 文件夹路径
  • options 选项配置( 可选 )
  • callback 操作后的回调

示例代码:

//1.引入fs模块
const fs = require('fs');
//2.可以使用 rmdir 或 rmdirSync 来删除文件
fs.rmdir('./a',{
    
    recursive:true},err=>{
    
    
    if(err) return;
    console.log('删除成功');
})
//3.现在版本可以用rm代替rmdir
fs.rm('./a',{
    
    recursive:true},err=>{
    
    
    if(err) return;
    console.log('删除成功');
})

//4.同步删除文件夹
fs.rmdirSync('./c',{
    
    recursive:true});

七、查看资源状态

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

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

参数说明:

  • path 文件夹路径
  • options 选项配置( 可选 )
  • callback 操作后的回调
//1.引入fs模块
const fs = require('fs');
//2.可以使用 stat 或 statSync 来查看资源的详细信息
//异步获取状态
fs.stat('./file',(err,data)=>{
    
    
    if(err) return;
    console.log(data.isDirectory())
})
//同步获取状态
let data = fs.statSync('./file/test.txt');
console.log(data);
/*
size 文件体积
birthtime 创建时间
mtime 最后修改时间
isFile 检测是否为文件
isDirectory 检测是否为文件夹
*/

结果值对象结构:

  • size 文件体积
  • birthtime 创建时间
  • mtime 最后修改时间
  • isFile 检测是否为文件
  • isDirectory 检测是否为文件夹

八、__dirname 和 path

8.1 __dirname

__dirname 与 require 类似,都是 Node.js 环境中的’全局’变量
__dirname 保存着 当前文件所在目录的绝对路径 ,可以使用 __dirname 与文件名拼接成绝对路径
代码示例:

//1.引入fs模块
const fs = require('fs');
//2.__dirname 保存着 当前文件所在目录的绝对路径 ,可以使用 __dirname 与文件名拼接成绝对路径
console.log(__dirname);
//读取文件
let data = fs.readFileSync(__dirname+'\\file\\test.txt');
console.log(data.toString())

8.2 path 模块

可以使用path模块进行路径的拼接,path 模块提供了 操作路径 的功能,我们将介绍如下几个较为常用的几个 API:

API 说明
path.resolve 拼接规范的绝对路径 常用
path.sep 获取操作系统的路径分隔符
path.parse 解析路径并返回对象
path.basename 获取路径的基础名称
path.dirname 获取路径的目录名
path.extname 获得路径的扩展名

代码示例:

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

猜你喜欢

转载自blog.csdn.net/lx00000025/article/details/132576198