Node.js / 系统课时
处理文件路径
处理文件路径
文件路径看似只是字符串,但分隔符、当前工作目录、..、扩展名和 Windows 盘符都会让直接拼接变得脆弱。本课用 Node.js 内置 node:path 完成拼接、规范化、拆解与边界校验,并给出可跨平台复用的写法。
学习目标
- 会区分
path.join()、path.resolve()与path.normalize()的职责。 - 会用
path.parse()、path.extname()等 API 拆解文件路径。 - 能在接收外部路径片段时检测目录穿越,避免越过指定根目录。
拼接、解析绝对路径与规范化
path.join() 负责按当前平台分隔符拼接并清理多余的 .、..;path.resolve() 会从右向左解析并得到绝对路径;path.normalize() 只整理现有路径。需要稳定演示不同平台时,可显式使用 path.posix 或 path.win32。
| API | 典型输入 | 结果特点 |
|---|---|---|
path.join() |
目录片段、文件名 | 不保证得到绝对路径 |
path.resolve() |
基准目录、相对片段 | 一定返回绝对路径 |
path.normalize() |
已有路径字符串 | 规范分隔符并折叠 .、.. |
保存为 path-basic.js 后执行 node path-basic.js:
const path = require('node:path');
console.log(path.posix.join('/srv/app', '..', 'logs', 'app.log'));
console.log(path.posix.resolve('/srv/app', '../logs/app.log'));
console.log(path.posix.normalize('/srv//app/../logs/'));
console.log(path.win32.join('C:\\app', 'logs', 'app.log'));预期输出:
/srv/logs/app.log
/srv/logs/app.log
/srv/logs/
C:\app\logs\app.logpath.resolve('logs', 'app.log') 会把 process.cwd() 作为起点,因此程序从不同目录启动时结果可能不同。若目标应固定在模块或配置目录下,应显式传入稳定的绝对基准目录,而不是依赖启动位置。
拆解文件名和扩展名
遇到“目录、文件名、扩展名分别是什么”时,不要手写 split('/')。path.parse() 一次返回 root、dir、base、ext、name,path.basename()、path.dirname() 和 path.extname() 则适合只取其中一个部分。
const path = require('node:path');
const file = '/srv/app/archive.tar.gz';
const info = path.posix.parse(file);
console.log(info.dir);
console.log(info.base);
console.log(info.name);
console.log(info.ext);
console.log(path.posix.basename(file, '.gz'));预期输出:
/srv/app
archive.tar.gz
archive.tar
.gz
archive.tar注意 path.extname('archive.tar.gz') 只返回最后一个扩展名 .gz,不会返回 .tar.gz。如果业务把“双扩展名”当作一个类型,需要在应用层另写规则,不要误解 extname() 的语义。
外部路径要检查是否越界
path.normalize() 不能单独防止目录穿越,因为 ../secret.txt 规范化后仍然可能指向根目录之外。处理上传目录、静态资源目录或导出目录时,应先用 path.resolve() 得到目标,再用 path.relative() 检查它是否仍位于允许的根目录内。
const path = require('node:path');
const root = path.resolve('public');
function safePath(requested) {
const target = path.resolve(root, requested);
const relative = path.relative(root, target);
// relative 指向上级目录或变成绝对路径时,目标已经逃出 root。
if (relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
throw new Error('路径越界');
}
return target;
}
console.log(path.basename(safePath('images/logo.png')));
try {
safePath('../secret.txt');
} catch (error) {
console.log(error.message);
}预期输出:
logo.png
路径越界这类检查保护的是“目标必须留在某个根目录中”这一约束;如果还要防符号链接把路径指向根目录外,需要在真正访问文件前结合 fs.realpath() 校验解析后的真实路径。
选择正确的路径写法
跨平台代码应把路径当作结构化数据处理。文件系统路径用 node:path;URL 用 URL API;要测试另一平台的路径规则时用 path.win32 或 path.posix。把 / 写死在字符串里,在 Windows、UNC 路径或盘符场景下很容易出现错误。
| 错误做法 | 更稳妥的做法 |
|---|---|
dir + '/' + file |
path.join(dir, file) |
手写 split('/') 取文件名 |
path.basename(file) |
用 normalize() 当安全校验 |
resolve() 后再用 relative() 检查边界 |
| 把 URL 的 pathname 直接当文件路径 | 使用 fileURLToPath() 做转换 |
只要先明确“这是文件系统路径还是 URL”,再选择对应 API,路径处理通常就能避开平台差异和隐蔽的边界错误。