在Node.js中，fs模块提供了多种方法来处理文件和目录操作，使得数据的持久性保存和文件管理变得简单。下面将介绍文件读写、文件复制、文件移动、文件重命名、文件删除、文件夹创建与删除以及查看资源状态等常用操作。

首先，在使用写入和读取功能前，我们需要导入fs模块，这是所有文件操作的基础：

const fs = require("fs");

一、文件写入

1. 异步写入

使用fs.writeFile方法异步写入文件。例如，写入一个三字经文件：

fs.writeFile("./三字经.txt", "人之初，性本善。", (err) => {
  if (err) {
    console.log("写入失败");
    return;
  }
  console.log("写入成功");
});
console.log("异步写入操作已发起");

注意：console.log("异步写入操作已发起"); 会在 writeFile 回调之前执行，因为 writeFile 是异步的。

2. 同步写入

如果需要同步执行，可以使用fs.writeFileSync方法：

try {
  fs.writeFileSync("./data.txt", "text");
  console.log("同步写入成功");
} catch (err) {
  console.error("同步写入错误:", err);
}
console.log("同步写入操作已完成");

这里的console.log("同步写入操作已完成");会在writeFile回调之后执行，因为writeFileSync是同步的。

3. 异步追加写入

使用fs.appendFile方法可以异步追加内容到文件末尾：

fs.appendFile("./三字经.txt", "性相近，习相远。", (err) => {
  if (err) {
    console.log("追加失败");
    return;
  }
  console.log("追加成功");
});

4、同步追加写入

同样，fs.appendFileSync方法用于同步追加写入：

try {
  fs.appendFileSync("./data.txt", "\r\n追加text");
  console.log("同步追加成功");
} catch (err) {
  console.error("同步追加错误:", err);
}

5. 使用fs.writeFile实现追加写入

通过设置flag: 'a'选项，fs.writeFile也可以用于追加写入：

fs.writeFile("./三字经.txt", "\r\n苟不教，父之过。", { flag: 'a' }, (err) => {
  if (err) {
    console.error("追加写入失败:", err);
    return;
  }
  console.log("追加写入成功");
});

6. 流式写入

对于大文件或需要持续写入的数据，使用流（stream）是一个更好的选择。使用fs.createWriteStream创建一个写入流并写入数据：

const ws = fs.createWriteStream('./静夜思.txt');

ws.write('窗前明月光，\r\n'); 
ws.write("疑是地上霜。\r\n");
ws.write("举头望明月，\r\n"); 
ws.write("低头思故乡。\r\n"); 

// 关闭流，确保数据完全写入文件

ws.end(() => {
  console.log("流式写入完成");
});
//ws.close()

通常不需要显式调用ws.close()来关闭写入流，因为close方法不会等待数据被刷新到磁盘，可能会导致数据未完全写入文件。

可以使用ws.end()，它会在数据写入完成后自动关闭流，确保数据完全写入文件。。

二、文件读取

1、异步读取

使用fs.readFile方法可以异步读取文件内容。异步读取不会阻塞事件循环，这对于需要处理大量I/O操作的Node.js应用至关重要：

// 异步读取 radFile（这里以 "三字经.txt" 为例）
fs.readFile("./三字经.txt", (err, data) => {
  if (err) {
    console.log("读取失败");
    return;
  }
  console.log(data.toString());
});

2、同步读取

使用fs.readFileSync方法可以实现文件的同步读取。但请注意，同步读取会阻塞事件循环，直到文件读取完成。因此，在实际应用中，尤其是服务器应用中，通常不推荐使用同步读取：

// 同步读取 radFileSync（这里以 "三字经.txt" 为例）

let data = fs.readFileSync("./三字经.txt");

console.log(data.toString());

3、流式读取

流式读取更加灵活高效，它可以逐块读取文件内容，而不是一次性将整个文件加载到内存中。这对于处理大文件非常有用

使用 fs.createReadStream 方法可以创建一个可读流。

// 流式读取 createReadStream（这里以 "三字经.txt" 为例）
const rs = fs.createReadStream('./三字经.txt');

// 绑定data事件，每次读取到数据块时触发
rs.on('data', chunk => {
    console.log(chunk);
    // chunk 是一个 Buffer 对象，代表读取到的数据块
    // 处理文本文件时，可将Buffer对象转换为字符串：chunk.toString()
});

// 绑定end事件，读取完成时触发
rs.on('end', () => {
    console.log("读取完成");
});

// 绑定error事件，读取过程中发生错误时触发
rs.on('error', err => {
    console.error("读取错误：", err);
});

建议至少绑定 error 事件来避免未捕获的异常导致程序崩溃

三、文件复制

文件复制可以通过读取源文件内容并写入到目标文件来实现，也可以使用流来更高效地处理大文件。

1、同步复制

// 读取文件内容
let data = fs.readFileSync("./三字经.txt");
// 写入文件
fs.writeFileSync("./复制三字经.txt", data)

2、流式操作

占用内存空间更小，使用流更高效处理大文件

// 创建读取流对象
const rs = fs.createReadStream('./三字经.txt')
// 创建写入流对象
const ws = fs.createWriteStream('./复制三字经2.txt');
// // 绑定data事件
rs.on('data', chunk => {
    ws.write(chunk)
})

// 或者使用 pipe() 方法

const rs2 = fs.createReadStream('./三字经.txt');
const ws2 = fs.createWriteStream('./复制三字经3.txt');
rs2.pipe(ws2);

四、文件移动与重命名

使用fs.rename或fs.renameSync方法可以实现文件的移动和重命名。

1、异步操作

fs.rename("oldname.txt", "newname.txt", (err) => {
  if (err) {
    console.log("重命名失败");
    return;
  }
  console.log("重命名成功");
});

fs.rename("path/to/oldfile.txt", "path/to/newfolder/newfile.txt", (err) => {
  if (err) {
    console.log("移动失败");
    return;
  }
  console.log("移动成功");
});

2、同步操作

fs.renameSync("oldname.txt", "newname.txt");

fs.renameSync("path/to/oldfile.txt", "path/to/newfolder/newfile.txt");

五、文件删除

使用fs.unlink/fs.unlinkSync或fs.rm/fs.rmSync方法删除文件。

1、异步操作

fs.unlink("file.txt", (err) => {
  if (err) {
    console.log("删除失败");
    return;
  }
  console.log("删除成功");
});

// Node.js 14.14.0及以上版本可以使用fs.rm

fs.rm("file.txt", (err) => {
  if (err) {
    console.log("删除失败");
    return;
  }
  console.log("删除成功");
});

2、同步操作

fs.unlinkSync("file.txt");

fs.rmSync("file.txt");

六、查看资源状态

使用fs.stat或fs.statSync方法查看文件或目录的状态。

1、异步操作

fs.stat("file.txt", (err, stats) => {
  if (err) {
    console.log("获取状态失败");
    return;
  }
  console.log("操作成功", stats);// 资源状态

  console.log(stats.isFile()); // 是否为文件
  console.log(stats.isDirectory()); // 是否为目录
});

2、同步操作

const stats = fs.statSync("file.txt");

七、文件夹操作

1、创建文件夹

使用fs.mkdir或fs.mkdirSync方法创建文件夹，{ recursive: true }用于递归创建：

fs.mkdir("newfolder", { recursive: true }, (err) => {
  if (err) {
    console.log("创建失败");
    return;
  }
  console.log("创建成功");
});


fs.mkdirSync("newfolderSync", { recursive: true });

2、读取文件夹

使用fs.readdir或fs.readdirSync方法读取文件夹内容。

fs.readdir("folder", (err, files) => {
  if (err) {
    console.log("读取失败");
    return;
  }
  console.log(files);
});

const filesSync = fs.readdirSync("folder");
console.log(filesSync);

3、删除文件夹

使用fs.rmdir或fs.rm方法删除文件夹，{ recursive: true, force: true }用于递归强制删除：

fs.rmdir("folder", { recursive: true }, (err) => {
  if (err) {
    console.log("删除失败");
    return;
  }
  console.log("删除成功");
});

// Node.js 14.14.0及以上版本

fs.rm("folder", { recursive: true, force: true }, (err) => {
  if (err) {
    console.log("删除失败");
    return;
  }
  console.log("删除成功");
});