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:

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'));

预期输出:

text
/srv/logs/app.log
/srv/logs/app.log
/srv/logs/
C:\app\logs\app.log

path.resolve('logs', 'app.log') 会把 process.cwd() 作为起点,因此程序从不同目录启动时结果可能不同。若目标应固定在模块或配置目录下,应显式传入稳定的绝对基准目录,而不是依赖启动位置。

拆解文件名和扩展名

遇到“目录、文件名、扩展名分别是什么”时,不要手写 split('/')。path.parse() 一次返回 root、dir、base、ext、name,path.basename()、path.dirname() 和 path.extname() 则适合只取其中一个部分。

js
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'));

预期输出:

text
/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() 检查它是否仍位于允许的根目录内。

js
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);
}

预期输出:

text
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,路径处理通常就能避开平台差异和隐蔽的边界错误。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理文件路径

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通