在Node.js中，文件系统（File System，简称fs）API提供了与本地文件系统进行交互的能力。从读取文件内容、写入文件、删除文件到创建目录等，Node.js的文件系统API为开发者提供了丰富的功能。本文将详细探讨Node.js文件系统API的基本使用和一些高级功能。
一、Node.js文件系统API的引入
在Node.js中，我们可以使用内置的fs模块来访问文件系统API。要使用这个模块，我们需要在代码中引入它：
const fs = require('fs');
一旦引入了这个模块，我们就可以调用其提供的各种方法来操作文件系统了。
二、基本的文件操作
1. 读取文件
使用fs.readFile()方法可以异步地读取文件的内容。该方法接受三个参数：文件路径、文件编码（可选）和一个回调函数。回调函数有两个参数：一个错误对象（如果没有错误则为null）和文件的内容。
fs.readFile('example.txt', 'utf8', (err, data) => {
if (err) throw err;
console.log(data);
});
2. 写入文件
fs.writeFile()方法用于异步地将数据写入文件。如果文件已经存在，则会被覆盖。该方法接受三个参数：文件路径、要写入的数据和一个回调函数。
const data = 'Hello, Node.js!';
fs.writeFile('example.txt', data, (err) => {
if (err) throw err;
console.log('The file has been saved!');
});
3. 删除文件
fs.unlink()方法用于删除文件。它接受一个文件路径和一个回调函数作为参数。
fs.unlink('example.txt', (err) => {
if (err) throw err;
console.log('The file has been deleted!');
});
4. 创建目录
fs.mkdir()方法用于创建目录。它接受一个目录路径和一个回调函数作为参数。
fs.mkdir('myDir', {
recursive: true }, (err) => {
if (err) throw err;
console.log('Directory has been created!');
});
注意：在fs.mkdir()中，通过{ recursive: true }选项可以确保即使父目录不存在，也能创建子目录。
三、文件流的使用
对于大型文件的操作，使用文件流（Streams）可以更加高效。Node.js的文件系统API支持流的操作，允许我们以流式的方式读取和写入文件。
1. 读取文件流
使用fs.createReadStream()方法可以创建一个读取文件内容的可读流。
const readStream = fs.createReadStream('example.txt');
readStream.on('data', (chunk) => {
console.log(chunk.toString());
});
readStream.on('end', () => {
console.log('End of file');
});
readStream.on('error', (err) => {
console.error('Error:', err);
});
2. 写入文件流
使用fs.createWriteStream()方法可以创建一个写入文件内容的可写流。
const writeStream = fs.createWriteStream('example.txt');
writeStream.write('Hello, ');
writeStream.write('Node.js!');
writeStream.end(); // 结束写入
writeStream.on('finish', () => {
console.log('File has been written');
});
writeStream.on('error', (err) => {
console.error('Error:', err);
});
四、文件系统的监视
Node.js的文件系统API还提供了fs.watch()和fs.watchFile()方法，用于监视文件和目录的变化。这些方法在文件或目录发生变化时触发回调函数。
五、总结
Node.js的文件系统API为开发者提供了丰富的功能，从基本的文件读写到高级的流操作和文件系统监视，都能够满足开发者在Node.js环境中进行文件操作的需求。通过掌握这些API的使用，我们可以更加高效地处理文件和目录，为Web应用程序或命令行工具提供强大的文件支持。
