Node.js / 系统课时
操作目录与文件信息
操作目录与文件信息
这一节用 node:fs/promises 完成目录创建、内容遍历、元数据读取和目录删除。做完后,你会得到一段可直接运行的脚本,并能根据 Dirent 与 Stats 判断条目类型、文件大小和最近修改时间。
学习目标
- 使用
mkdir()创建多级目录,并理解recursive对重复执行的影响。 - 使用
readdir()、stat()读取目录内容、文件大小和时间信息。 - 使用
rm()删除目录,并通过错误码验证删除是否真正完成。
创建目录时让重复执行可控
以下示例以 Node.js 22+ 的 ESM 写法为基线,文件扩展名使用 .mjs。创建多级目录时使用 mkdir(path, { recursive: true }),父目录不存在会一并创建;目标目录已经存在时也不会因为 EEXIST 直接失败,适合初始化缓存目录、上传目录和构建输出目录。
如果你只允许“目录必须是新建的”,就不要传 recursive: true。这时目标已存在会抛出错误,调用方可以据此阻止覆盖已有工作区。目录权限的 mode 在 POSIX 系统上有意义,但 Windows 不应依赖它实现访问控制。
遍历目录并读取文件信息
readdir(path, { withFileTypes: true }) 返回 Dirent,可以先用 isFile()、isDirectory() 区分类型,再决定是否调用 stat()。这样比对每个条目都先做一次 stat() 更省系统调用。下面的主示例会创建目录和文件、遍历内容、打印文件大小与修改时间,最后删除一个子目录。
import { access, mkdir, readdir, rm, stat, writeFile } from 'node:fs/promises';
import { join } from 'node:path';
const root = join(process.cwd(), 'fs-demo');
const inbox = join(root, 'inbox');
const archive = join(inbox, 'archive');
// 先清理旧演示数据,保证脚本重复运行时结果一致。
await rm(root, { recursive: true, force: true });
await mkdir(archive, { recursive: true });
await writeFile(join(inbox, 'note.txt'), 'hello\n', 'utf8');
const entries = await readdir(inbox, { withFileTypes: true });
entries.sort((a, b) => a.name.localeCompare(b.name));
for (const entry of entries) {
const fullPath = join(inbox, entry.name);
if (entry.isDirectory()) {
console.log(`${entry.name} | directory`);
continue;
}
// Stats 里的 size 是字节数,mtime 是最近一次内容修改时间。
const info = await stat(fullPath);
console.log(`${entry.name} | file | ${info.size} bytes | ${info.mtime.toISOString()}`);
}
await rm(archive, { recursive: true, force: true });
try {
await access(archive);
} catch (error) {
console.log(`archive removed: ${error.code}`);
}将代码保存为 directory-info.mjs 后运行:
node directory-info.mjs预期输出:
archive | directory
note.txt | file | 6 bytes | <TIME>
archive removed: ENOENT<TIME> 会替换为实际的 ISO 时间。这里写入的是 hello 加一个换行,共 6 个 UTF-8 字节,因此 size 为 6;如果写入中文、图片或压缩文件,不能用字符数推断字节数。
选择 stat、lstat 和时间字段
stat(path) 会跟随符号链接,返回链接目标的信息;需要检查“链接本身”时改用 lstat(path)。常用字段中,size 是字节数,mtime 是内容最近修改时间,ctime 是元数据最近变化时间;不要把 ctime 当成跨平台可靠的“创建时间”。
项目里通常把展示时间统一转成 toISOString(),再由界面层按时区格式化。若只想筛选大文件,可以直接判断 info.size >= 10 * 1024 * 1024,这表示至少 10 MiB,避免把字符串格式化后的 "10 MB" 再拿来比较。
删除目录时先限定操作边界
删除空目录可以使用 rm(path);删除包含文件或子目录的目录时使用 rm(path, { recursive: true })。加入 force: true 后,目标不存在也不会因为缺失而失败,适合清理临时目录,但它也会让“路径写错”更难被及时发现。
生产脚本不要把用户输入直接传给递归删除。至少先用 resolve() 得到绝对路径,并确认目标位于允许的工作目录内;像项目根目录、用户主目录或磁盘根目录都应设置成禁止删除区。删除后可用 access() 做一次确认:成功代表仍存在,抛出 ENOENT 才表示路径已经不存在。