Linux 下 Node.js 文件系统操作指南
在 Linux 环境下用 Node.js 操作文件系统，是服务器端开发绕不开的基本功。无论是处理日志、管理配置文件，还是搭建静态文件服务，都离不开对文件的读写、复制和删除。这里先说说核心思路和常见的坑。
核心模块与调用方式
Node.js 的文件系统操作，核心就是内置的 fs 模块。光有它还不够，通常还得配合 path 模块来处理跨平台路径，以及 os 模块来获取系统相关的常量（比如换行符）。这三个组合在一起，基本能覆盖大部分需求。
关于调用风格，Node.js 给了三种选择：
- 回调风格：
fs.readFile(path, 'utf8', callback)—— 最经典，但回调嵌套深了容易“回调地狱”。 - Promise 风格：
fs.promises.readFile(path, 'utf8')—— 推荐，配合 async/await 写起来很清爽。 - 同步风格：
fs.readFileSync(path, 'utf8')—— 会阻塞事件循环，适合脚本初始化或启动阶段。
常用的 API 其实就那些，列出来一目了然：
- 读取：
fs.readFile / readFileSync - 写入：
fs.writeFile / writeFileSync（默认是覆盖写入） - 追加：
fs.appendFile / appendFileSync - 复制：
fs.copyFile - 目录操作：
fs.mkdir / readdir / rmdir - 删除：
fs.unlink（删除文件）、fs.rm/fs.rmdir（删除目录，支持递归） - 重命名/移动：
fs.rename - 获取状态：
fs.stat / statSync
一个小提示：Linux 下路径分隔符是 /，如果想让代码在 Windows 上也跑得通，记得用 path.join 来拼接路径。换行符方面，直接用 os.EOL 就能适配不同系统，省心。
常用操作代码示例
直接上代码，这些都是实际开发中经常用到的组合。
// 1) 读取
const fs = require('fs').promises;
const path = require('path');
const os = require('os');
const file = path.join(__dirname, 'data.txt');
const content = await fs.readFile(file, 'utf8');
console.log(content);
// 2) 写入（覆盖）与追加
await fs.writeFile(file, '第一行\n', { mode: 0o644 }); // 设置文件权限为 0644
await fs.appendFile(file, `追加行 ${os.EOL}`, 'utf8');
// 3) 复制
await fs.copyFile(file, path.join(__dirname, 'data.bak.txt'));
// 4) 目录：创建多级、遍历
await fs.mkdir(path.join(__dirname, 'logs'), { recursive: true });
const files = await fs.readdir(__dirname);
console.log(files);
// 5) 重命名/移动
await fs.rename(
path.join(__dirname, 'data.bak.txt'),
path.join(__dirname, 'archive', 'data.txt')
);
// 6) 删除：文件与目录（递归删除）
await fs.unlink(path.join(__dirname, 'archive', 'data.txt'));
await fs.rm('logs', { recursive: true, force: true }); // 递归删除目录
// 7) 状态与类型判断
const st = await fs.stat(file);
console.log(st.isFile(), st.isDirectory());
几点说明：
writeFile默认是覆盖写入，如果只想追加内容，记得用appendFile。fs.rm(..., { recursive: true })可以递归删除目录，算是比较现代的做法。如果遇到旧版 Node.js，可能需要用fs.rmdir配合手动遍历，或者借助第三方库。mode: 0o644是 Linux 下常见的文件权限设置，直接写在写入操作里就能生效。
大文件与性能建议
处理大文件时，最忌讳的就是一口气把整个文件读进内存。这时候就要请出流（Stream）了。
下面是一个用流来复制大文件的示例，通过管道（pipe）高效传输数据：
const fs = require('fs');
const read = fs.createReadStream('big.log', 'utf8');
const write = fs.createWriteStream('big.log.bak');
read.on('error', err => console.error('read error', err));
write.on('error', err => console.error('write error', err));
write.on('finish', () => console.log('copy done'));
read.pipe(write);
如果需要对大文件做逐行处理（比如分析日志），可以用 readline 模块配合流：
const fs = require('fs');
const readline = require('readline');
const rl = readline.createInterface({
input: fs.createReadStream('big.log', 'utf8'),
crlfDelay: Infinity
});
for await (const line of rl) {
// 处理每一行
console.log(line);
}
流和逐行读取的核心优势，就是在处理大文件时内存占用低、稳定性高。想想看，如果是几个G的日志文件，用 readFile 去读，机器不直接崩了才怪。
权限与跨平台注意
Linux 的权限模型是它的传统强项，但也容易踩坑。设置文件权限可以用 fs.writeFile 的 mode 参数（比如 0o755、0o644），或者直接用 fs.chmod / chmodSync 单独修改。一个基本原则：不要给敏感文件设置 0777 这种过于宽泛的权限，这点在 Linux 上尤其值得注意。
路径和换行符是跨平台开发的老生常谈。Linux 路径分隔符是 /，而 Windows 是 \，用 path.join 或 path.resolve 就能自动适应。换行符方面，Linux 是 \n，Windows 是 \r\n，直接用 os.EOL 即可统一处理。
编码方面，如果没指定 encoding，fs.readFile 默认返回的是 Buffer，常用的文本编码是 utf8。如果需要处理 GBK 这类非 UTF-8 编码的文件，可以借助 iconv-lite 等库进行转码，自己去写解码逻辑就太折腾了。
