文件系统与 path

这一课你将能做到

1. 用 node:fs/promises 完成读、写、追加、建目录、列目录、改名、删除等常见文件操作
2. 用 node:path 拼出跨平台不出错的路径，说清 join 与 resolve 的区别
3. 判断什么时候能用同步 API、什么时候必须异步，并理解 ENOENT 等常见错误码

为什么要学

Node 离开浏览器最大的红利就是能碰文件系统：内容批量替换、日志分析、生成报表、把配置落到磁盘……全都绕不开 fs。而路径错误是文件操作里最高频的事故源——Windows 用 \，macOS/Linux 用 /，C:\ 和 /home/ 的绝对路径写法也不同，全靠 path 模块兜底。

本站的很多工程脚本（把 Markdown 导入数据库、生成静态页）就是 fs + path + 第 2 课的 process.argv 组合出来的。这课学完，你就能独立写「读一批文件、处理、写回去」的完整工具。

先建立图像

fs 的三套 API（同一件事三种写法）：

  node:fs/promises   → await fs.readFile(...)   ← 首选，不阻塞、写法清爽
  node:fs (callback) → fs.readFile(..., cb)     ← 老代码，保持会读即可
  node:fs (sync)     → fs.readFileSync(...)     ← 启动期/脚本一次性场景

path 的分工：

  join('a', 'b', 'c.txt')    → a\b\c.txt   拼接（自动补分隔符）
  resolve('a', 'b.txt')      → h:\work\a\b.txt  从 cwd 出发算绝对路径
  __dirname                  → 脚本自己的目录（最稳的锚点）

记忆口诀：路径用 join 拼、位置用 resolve 算、锚点是 __dirname。

跟着做

步骤 1：读文件（promises 版）

新建 node-fs 目录，npm init -y。先造一个样本文件 note.txt（内容随意），再新建 read.js：

// read.js
const fs = require('node:fs/promises');
const path = require('node:path');

async function main() {
  const filePath = path.join(__dirname, 'note.txt');
  const text = await fs.readFile(filePath, 'utf8');
  console.log('内容:', text);
}

main();

node read.js
# 内容: （你 note.txt 里的内容）

两个关键点：'utf8' 不传会拿到 Buffer（二进制对象，打印出来是十六进制）；readFile 返回 Promise，必须 await 或 .then。

步骤 2：写文件与追加

新建 write.js：

// write.js
const fs = require('node:fs/promises');
const path = require('node:path');

async function main() {
  const file = path.join(__dirname, 'log.txt');

  await fs.writeFile(file, '第一行\n', 'utf8');        // 整体覆盖
  await fs.appendFile(file, '第二行\n', 'utf8');       // 追加
  await fs.appendFile(file, '第三行\n', 'utf8');

  const content = await fs.readFile(file, 'utf8');
  console.log(content);
}

main();