路径拼接、解析、规范化、相对路径转换

在 Node.js 的文件操作中，几乎每一步都离不开对路径的处理。path 模块封装了跨平台的路径操作逻辑，几个最常用的方法——join、resolve、normalize、relative 以及 parse/format——构建了我们日常拼接、解析和转换路径的基础。掌握它们不仅能避免手动拼接字符串带来的跨平台兼容性问题，还能减少路径安全漏洞（如路径遍历攻击）。

路径拼接：`path.join(...paths)`

path.join 是最常用的路径拼接方法，它将任意数量的路径片段连接起来，同时进行以下操作：

使用当前平台的分隔符（POSIX 为 /，Windows 为 \）连接各片段。
自动规范化路径（例如将多余的 / 或 \ 合并）。
正确处理相对路径标识 . 和 ..。

它的典型使用场景是拼接目录路径，例如从项目根目录构建一个日志文件的路径：

const path = require('path');
const logPath = path.join(__dirname, 'logs', 'app.log');
// POSIX:   /home/user/project/logs/app.log
// Windows: C:\users\user\project\logs\app.log

join 会忽略空字符串参数，但需要注意的是，如果某个参数以操作系统的根路径分隔符开头（如 Linux 下的 /），之前拼接的片段会被丢弃。因此，永远不要用 join 来拼接用户输入的路径片段来直接访问文件系统，除非你做了严格的清理。

// 危险！如果 userInput = "/etc/passwd"，将直接返回 /etc/passwd
const unsafe = path.join('/safe/dir', userInput);

路径解析为绝对路径：`path.resolve(...paths)`

path.resolve 的行为和 join 类似，但它会将结果解析为绝对路径。它的计算逻辑是从右向左处理参数，直到构造出一个绝对路径；如果所有参数拼接后仍为相对路径，它会自动附加当前工作目录（process.cwd()）作为前缀。

// 假设当前工作目录为 /home/user
console.log(path.resolve('src', 'app.js'));       // /home/user/src/app.js
console.log(path.resolve('/etc', 'nginx'));       // /etc/nginx
console.log(path.resolve('/etc', '..', 'nginx')); // /nginx
console.log(path.resolve());                      // /home/user  (当前工作目录)

resolve 特别适合将用户输入或命令行参数中的路径转换为可靠的绝对路径：

const configFile = path.resolve(process.argv[2] || './config.json');

注意 resolve 同样会受到参数中根路径的影响，一旦遇到以 / 开头的参数，此前拼接的部分全部作废。此外，resolve 不检查路径是否存在，仅仅做字符串处理。

路径规范化：`path.normalize(path)`

实际开发中，我们得到的路径可能包含冗余的分隔符、. 和 .. 等混乱的表示。path.normalize 可以将其整理为标准形式，它会：

将连续的多个分隔符压缩为一个。
正确跟随 .. 和 . 来折叠路径。
保留路径末尾的 /（除非路径末尾是多个分隔符，则会清理）。

path.normalize('/foo/bar//baz/asdf/quux/..');
// 返回: '/foo/bar/baz/asdf'

这个方法在接收用户输入或从配置中读取路径时非常有用，可以避免因路径不规范导致的文件找不到。

计算相对路径：`path.relative(from, to)`

path.relative 返回从 from 目录到 to 路径的相对路径。如果 from 和 to 定位到同一个路径（经过规范化），则返回空字符串。

该方法常用于生成资源引用路径或者日志中展示文件的相对位置：

path.relative('/data/orandea/test/aaa', '/data/orandea/impl/bbb');
// 返回: '../../impl/bbb'

若 from 和 to 位于不同的盘符或挂载点（如在 Windows 上一个是 C:，另一个是 D:），path.relative 会直接返回 to 的绝对路径（经过规范化）。此时需要特别注意是否会导致意外的访问。

路径分解与构造：`path.parse` / `path.format`

path.parse 将路径字符串拆解为一个对象，包含 root、dir、base、name、ext 五个属性，非常便于获取文件名、扩展名或目录名。

path.parse('/home/user/dir/file.txt');
// 返回：
// {
//   root: '/',
//   dir: '/home/user/dir',
//   base: 'file.txt',
//   ext: '.txt',
//   name: 'file'
// }

反之，path.format 接受这样一个对象，将其重构为路径字符串。这两个方法严格遵守各自平台的路径规则，可以用来在业务中统一处理和变换文件名。

实践中的常见陷阱与最佳实践

避免手动拼接字符串

永远使用 path.join 或 path.resolve 来组合路径，而不是 'a' + '/' + 'b'。手动拼接会引入跨平台分隔符问题，并且在高并发下容易拼出安全漏洞。

输入安全

如果路径片段来自外部（客户端请求、命令行参数），必须进行路径清理。常见做法是使用 path.normalize 处理后再用 path.resolve 拼接到一个受控的基目录中，然后检查结果是否仍在该目录下，防止路径遍历攻击（例如 ../../../etc/passwd）。

__dirname vs process.cwd()

dirname 返回当前执行脚本所在的目录（绝对路径），在模块中编译时确定，不受运行目录影响。process.cwd() 则是进程的当前工作目录，可能因用户运行 node 的位置不同而变化。构建可靠路径时，优先使用 dirname。

尾部分隔符

在 Windows 上，path.join('foo', '/') 会得到 foo\，这与 POSIX 的 foo/ 不同。如果需要在 URL 组装时使用，通常需要额外的替换逻辑，但多数场景下不必纠结。

分隔符属性

path.sep 返回当前平台的分隔符（/ 或 \），path.delimiter 是环境变量分隔符（: 或 ;）。在处理动态路径字符串时，可以用它们来编写更通用的代码。

总结

path 模块的这几个核心 API 看似简单，却构成了 Node.js 文件操作的基础框架。join 负责安全拼接，resolve 负责绝对化，normalize 负责清理紊乱，relative 负责生成相对路径，而 parse/format 则负责拆解与重组。工作时将它们组合使用，既能编写跨平台的稳健代码，也能避免大量因路径错误引发的线上故障。

路径拼接、解析、规范化、相对路径转换

路径拼接：path.join(...paths)

路径解析为绝对路径：path.resolve(...paths)

路径规范化：path.normalize(path)

计算相对路径：path.relative(from, to)

路径分解与构造：path.parse / path.format