1.零基础Nodejs快速入门——fs模块

本文详细介绍了Node.js中的fs模块,包括文件写入(异步与同步)、文件读取(读取File与FileSync)、文件移动与重命名、删除文件、文件夹操作(mkdir,readdir,rmdir)、查看资源状态以及处理相对路径和使用__dirname。通过实例演示了各种操作方法及其应用场景。
摘要由CSDN通过智能技术生成

fs 模块

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

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

1.   文件写入

2.   文件读取

3.   文件移动与重命名

4.   文件删除

5.   文件夹操作

6.   查看资源状态

一、文件写入

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

方法

说明

writeFile

异步写入

writeFileSync

同步写入

append File / append FileSync

追加写入

createWriteStream

流式写入

1-1. writeFile 异步写入

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

参数说明:

 

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

返回值:   undefined  

代码示例:

 

//  require   Node .js  环境中的 '全局 '变量,用来导入模块

const  fs  =  require( 'fs ' ) ;

//将 『三人行,必有我师焉。』 写入到当前文件夹下的『座右铭 .txt』文件中

fs.writeFile ( ' . /座右铭 .txt ' ,  '三人行,必有我师焉。 ' ,  err  =>  {

//如果写入失败,则回调函数调用时,会传入错误对象,如写入成功,会传入 null

if(err){

console .log(err) ;

return;

}

console .log( '写入成功 ' )

}) ;

1-2. writeFileSync 同步写入

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

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

返回值:  undefined  

代码示例:

try{
fs.writeFileSync( ' . /座右铭 .txt ' ,  '三人行,必有我师焉。 ' ) ;
}catch(e ){
console .log(e ) ;
}

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

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

效率较好

1-3 append File / append FileSync 追加写入

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

语法:

fs .append File (file ,  data [ ,  options] ,  callback)

fs .append FileSync(file ,  data [ ,  options])  

返回值:  二者都为

实例代码:

 

fs.append File ( ' . /座右铭 .txt ' , '择其善者而从之,其不善者而改之。 ' ,  err  =>  {

if(err)  throw  er r;

console .log( '追加成功 ' )

}) ;

fs.append FileSync( ' . /座右铭 .txt ' , ' \r\n温故而知新,  可以为师矣 ' ) ;

1-4. createWriteStream 流式写入

语法:    fs .createWriteStream(path[ ,  options])  

参数说明:

    path  文件路径

    options  选项配置(可选 

返回值:  Object  

代码示例:

let  ws  =  fs.createWriteStream( ' . /观书有感 .txt ' ) ;

ws .write( '半亩方塘一鉴开\r\n ' ) ;

ws .write( '天光云影共徘徊\r\n ' ) ;

ws .write( ' 问渠那得清如许\r\n ' ) ;

ws .write( '为有源头活水来\r\n ' ) ;

ws .end() ;

1-5 写入文件的场景

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

   下载文件

  安装软件

  保存程序日志,如 Git

  视频录制

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

二、文件读取

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

 

方法

说明

read File

异步读取

read FileSync

同步读取

createReadStream

流式读取

2-1 read File 异步读取

语法:  fs . read File (path[ ,  options] ,  callback)

参数说明:

    path  文件路径

    options  选项配置

    callback  回调函数

返回值:   undefined  

代码示例:

//导入 fs 模块
const fs = require('fs');
fs.readFile('./座右铭.txt', (err, data) => {
if(err) throw err;
console.log(data);
});
fs.readFile('./座右铭.txt', 'utf-8',(err, data) => {
if(err) throw err;
console.log(data);
});

2-2 read FileSync 同步读取

语法:  fs . read FileSync(path[ ,  options])

参数说明:

    path  文件路径

    options  选项配置

返回值:   string   |  Buffer  

代码示例:

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

2-3 createReadStream 流式读取

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

参数说明:

    path  文件路径

 

    options  选项配置( 可选 

返回值:   Object  

代码示例:

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

2-4 读取文件应用场景

  •    电脑开机
  •   程序运行
  •   编辑器打开文件
  •   查看图片
  •   播放视频
  •   播放音乐
  •     Git 查看日志
  •    上传文件
  •   查看聊天记录

 

三、文件移动与重命名

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

fs . rename (oldPath ,  newPath ,  callback)  

fs . renameSync(oldPath ,  newPath)  

参数说明:

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

代码示例:

fs. rename ( ' . /观书有感 .txt ' ,  ' . /论语/观书有感 .txt ' ,  (err)  =>{

if(err)  throw  er r;

console .log( '移动完成 ' )

}) ;

fs. renameSync( ' . /座右铭 .txt ' ,  ' . /论语/我的座右铭 .txt ' ) ;

 

 

四、文件删除

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

 

fs .unlink(path ,  callback)

fs .unlinkSync(path)

参数说明:

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

代码示例:

const  fs  =  require( 'fs ' ) ;

fs.unlink( ' . /test .txt ' ,  err  =>  {

if(err)  throw  er r;

console .log( '删除成功 ' ) ;

}) ;

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

五、文件夹操作

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

方法

说明

mkdir / mkdirSync

创建文件夹

readdir / readdirSync

读取文件夹

rmdir / rmdirSync

删除文件夹

 

5-1 mkdir 创建文件夹

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

语法:

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

fs .mkdirSync(path[ ,  options])

参数说明:

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

示例代码:

//异步创建文件夹
fs.mkdir('./page', err => {
if(err) throw err;
console.log('创建成功');
});
//递归异步创建
fs.mkdir('./1/2/3', {recursive: true}, err => {
if(err) throw err;
console.log('递归创建成功');
});
//递归同步创建文件夹
fs.mkdirSync('./x/y/z', {recursive: true});

 

5-2 readdir 读取文件夹

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

语法:

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

fs . readdirSync(path[ ,  options])

参数说明:

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

示例代码:

//异步读取

fs. readdir( ' . /论语 ' ,  (err ,  data)  =>  {

if(err)  throw  er r;

console .log(data) ;

}) ;

//同步读取

let  data  =  fs. readdirSync( ' . /论语 ' ) ;

console .log(data) ;

5-3 rmdir 删除文件夹

Node.js 中,我们可以使用  rmdir    rmdirSync  删除文件夹

语法:

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

fs . rmdirSync(path[ ,  options ])

参数说明:

    path       文件夹路径

    options   选项配置( 可选 

    callback   操作后的回调

示例代码:

//异步删除文件夹
fs.rmdir('./page', err => {
if(err) throw err;
console.log('删除成功');
});
//异步递归删除文件夹
fs.rmdir('./1', {recursive: true}, err => {
if(err) {
console.log(err);
}
console.log('递归删除')
});
//同步递归删除文件夹
fs.rmdirSync('./x', {recursive: true})

 

 

六、查看资源状态

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

语法:

 

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

fs .statSync(path[ ,  options])

参数说明:

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

示例代码:

//异步获取状态
fs.stat('./data.txt', (err, data) => {
if(err) throw err;
console.log(data);
});
//同步获取状态
let data = fs.statSync('./data.txt');

结果值对象结构:

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

 

七、相对路径问题

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

  相对路径

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

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

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

  绝对路径

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

    /us r/bin                   Linux 系统下的绝对路径

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

八、__dirname

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

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

代码示例:

let  data  =  fs. read FileSync(__dirname  +  ' /data .txt ' ) ;

console .log(data) ;

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

九、练习

1.   编写一个 JS 文件,实现复制文件的功能

2.   文件重命名

  • 19
    点赞
  • 31
    收藏
    觉得还不错? 一键收藏
  • 3
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值