Node.js 中文件系统模块（fs）的详细总结，包括定义、作用、各种写入方式及使用场景：
🧩 一、fs 模块简介
✅ 定义
fs（File System）是 Node.js 官方内置模块，用于实现对文件和目录的操作。
✅ 作用
可以与硬盘文件系统进行交互，支持以下操作：
- 创建文件 / 文件夹
- 删除文件 / 文件夹
- 重命名、移动文件
- 写入 / 读取文件内容
- 读取 / 修改文件权限
- 操作文件流（读写大文件）
✍️ 二、写入文件的方式
1. 同步写入 fs.writeFileSync(path, data[, options])
const fs = require('fs');
fs.writeFileSync('test.txt', 'Hello Node.js');
- 📌 阻塞主线程，适用于脚本执行环境或初始化配置写入。
- ✅ 使用场景：程序启动前写入配置文件、小文件快速写入等。
2. 异步写入 fs.writeFile(path, data[, options], callback)
const fs = require('fs');
fs.writeFile('test.txt', 'Hello Async!', (err) => {if (err) throw err;console.log('写入完成');
});
- 📌 非阻塞主线程，更加推荐在服务中使用。
- ✅ 使用场景：高并发写入、Web 接口处理时写日志、缓存等。
3. 同步追加写入 fs.appendFileSync(path, data[, options])
fs.appendFileSync('log.txt', '日志记录A\n');
- 📌 用于在文件末尾追加内容，阻塞执行。
- ✅ 使用场景：脚本执行中逐步记录日志。
4. 异步追加写入 fs.appendFile(path, data[, options], callback)
fs.appendFile('log.txt', '日志记录B\n', (err) => {if (err) throw err;
});
- 📌 追加内容，不覆盖原文件，异步执行。
- ✅ 使用场景：日志系统、用户行为记录等。
💧 三、流式写入（适合大文件）
使用 fs.createWriteStream(path[, options])
const fs = require('fs');
const writeStream = fs.createWriteStream('bigfile.txt');writeStream.write('第一段内容\n');
writeStream.write('第二段内容\n');
writeStream.end('结束内容\n');
- 📌 优点：支持分段写入、内存使用更少。
- ✅ 使用场景：
- 写入大型日志、音视频文件
- 实时写入数据（如上传转存）
📑 四、使用场景对比表
| 用法 | 是否异步 | 特点 | 适用场景 |
|---|---|---|---|
writeFileSync | ❌ 同步 | 简单快速，阻塞主线程 | 初始化写配置，小文件 |
writeFile | ✅ 异步 | 推荐使用，不阻塞 | 高并发写操作 |
appendFileSync | ❌ 同步 | 顺序追加，简单可靠 | 单线程追加日志 |
appendFile | ✅ 异步 | 推荐用于日志等追加 | 用户行为记录，报错日志 |
createWriteStream | ✅ 异步 | 写入大文件、性能好 | 音视频、日志流、长连接数据 |
🧠 补充：写入选项说明
在写入方法中，可使用 options 参数来自定义格式，如：
fs.writeFileSync('example.txt', '内容', {encoding: 'utf8',flag: 'w' // 'w'写入 'a'追加
});
如果你还需要了解 读取文件的方式 或 fs/promises 的 Promise 写法版本，我也可以详细补充，要不要一并讲讲？