fs 文件系统模块
1、什么是 fs 文件系统模块
fs 模块是 Node.js 官方提供的、用来操作文件的模块。它提供了一系列的方法和属性,用来满足用户对文件的操作需求。
方法名
说明
fs.()
fs.()
用来向指定的文件中写入内容
如果要在 代码中,使用 fs 模块来操作文件,则需要使用如下的方式先导入它:
2、读取指定文件中的内容 (1)fs.() 的语法格式
使用 fs.() 方法,可以读取指定文件中的内容,语法格式如下:
参数解读:
(2)fs.() 的示例代码
以 utf8 的编码格式,读取指定文件的内容,并打印 err 和 的值:
// 1. 导入 fs 模块,来操作文件
const fs = require('fs')// 2. 调用 fs.readFile() 方法读取文件
// 参数1:读取文件的存放路径
// 参数2:读取文件时候采用的编码格式,一般默认指定 utf8
// 参数3:回调函数,拿到读取失败和成功的结果 err dataStr
fs.readFile('./files/11.txt', 'utf8', function(err, dataStr) {// 2.1 打印失败的结果// 如果读取成功,则 err 的值为 null// 如果读取失败,则 err 的值为 错误对象,dataStr 的值为 undefinedconsole.log(err)console.log('-------')// 2.2 打印成功的结果console.log(dataStr)
})
(3)判断文件是否读取成功
可以判断 err 对象是否为 null,从而知晓文件读取的结果:
const fs = require('fs')fs.readFile('./files/11.txt', 'utf8', function(err, dataStr) {if (err) {return console.log('读取文件失败!' + err.message)}console.log('读取文件成功!' + dataStr)
})
3、向指定的文件中写入内容 (1)fs.() 的语法格式
使用 fs.() 方法,可以向指定的文件中写入内容,语法格式如下:
参数解读:
(2)fs.() 的示例代码
向指定的文件路径中,写入文件内容:
// 1. 导入 fs 文件系统模块
const fs = require('fs')// 2. 调用 fs.writeFile() 方法,写入文件的内容
// 参数1:表示文件的存放路径
// 参数2:表示要写入的内容
// 参数3:回调函数
fs.writeFile('./files/3.txt', 'ok123', function(err) {// 2.1 如果文件写入成功,则 err 的值等于 null// 2.2 如果文件写入失败,则 err 的值等于一个 错误对象// console.log(err)if (err) {return console.log('文件写入失败!' + err.message)}console.log('文件写入成功!')
})
(3)判断文件是否写入成功
可以判断 err 对象是否为 null,从而知晓文件写入的结果:
// 1. 导入 fs 模块
const fs = require('fs')// 2. 调用 fs.readFile() 读取文件的内容
fs.readFile('../素材/成绩.txt', 'utf8', function(err, dataStr) {// 3. 判断是否读取成功if (err) {return console.log('读取文件失败!' + err.message)}console.log('读取文件成功!' + dataStr)
4、练习 - 考试成绩整理
使用 fs 文件系统模块,将素材目录下成绩.txt文件中的考试数据,整理到成绩-ok.txt文件中。
整理前,成绩.txt文件中的数据格式如下:
小红=99 小白=100 小黄=70 小黑=66 小绿=88
整理完成之后,希望得到的成绩-ok.txt文件中的数据格式如下:
小红:99
小白:100
小黄:70
小黑:66
小绿:88
核心实现步骤
// 1. 导入 fs 模块
const fs = require('fs')// 2. 调用 fs.readFile() 读取文件的内容
fs.readFile('../素材/成绩.txt', 'utf8', function(err, dataStr) {// 3. 判断是否读取成功if (err) {return console.log('读取文件失败!' + err.message)}// console.log('读取文件成功!' + dataStr)// 4.1 先把成绩的数据,按照空格进行分割const arrOld = dataStr.split(' ')// 4.2 循环分割后的数组,对每一项数据,进行字符串的替换操作const arrNew = []arrOld.forEach(item => {arrNew.push(item.replace('=', ':'))})// 4.3 把新数组中的每一项,进行合并,得到一个新的字符串const newStr = arrNew.join('\r\n')// 5. 调用 fs.writeFile() 方法,把处理完毕的成绩,写入到新文件中fs.writeFile('./files/成绩-ok.txt', newStr, function(err) {if (err) {return console.log('写入文件失败!' + err.message)}console.log('成绩写入成功!')})
})
5、fs 模块 - 路径动态拼接的问题
在使用 fs 模块操作文件时,如果提供的操作路径是以 ./ 或 ../ 开头的相对路径时,很容易出现路径动态拼接错误的问题。
原因:代码在运行的时候,会以执行 node 命令时所处的目录,动态拼接出被操作文件的完整路径。
解决方案:在使用 fs 模块操作文件时,直接提供完整的路径,不要提供 ./ 或 ../ 开头的相对路径,从而防止路径动态拼接的问题。
:表示当前文件所处的目录,这是node给我们提供的一个函数
const fs = require('fs')// 出现路径拼接错误的问题,是因为提供了 ./ 或 ../ 开头的相对路径
// 如果要解决这个问题,可以直接提供一个完整的文件存放路径就行
/* fs.readFile('./files/1.txt', 'utf8', function(err, dataStr) {if (err) {return console.log('读取文件失败!' + err.message)}console.log('读取文件成功!' + dataStr)
}) */// 移植性非常差、不利于维护
/* fs.readFile('C:\\Users\\escook\\Desktop\\Node.js基础\\day1\\code\\files\\1.txt', 'utf8', function(err, dataStr) {if (err) {return console.log('读取文件失败!' + err.message)}console.log('读取文件成功!' + dataStr)
}) */// __dirname 表示当前文件所处的目录
// console.log(__dirname)fs.readFile(__dirname + '/files/1.txt', 'utf8', function(err, dataStr) {if (err) {return console.log('读取文件失败!' + err.message)}console.log('读取文件成功!' + dataStr)
})