文件系统操作是Node.js后端开发中绕不开的话题，而几乎所有文件操作的第一步都是确定路径。不少初学者习惯直接用字符串拼接路径，比如'/usr/local' + '/' + 'lib'，这种写法在单一系统上可能碰巧能跑，一旦项目部署到不同操作系统，分隔符差异就会让程序莫名报错。Node.js内置的path模块正是为了解决这类问题而存在的，它屏蔽了Windows与类Unix系统在路径表示上的差异，提供了一套统一的路径处理API。本文将围绕路径拼接、路径解析和路径规范化三个核心场景，详细讲解path模块的常用方法与易错点。
一、路径拼接：join与resolve不是一回事
提到路径拼接，最常用的两个方法是path.join()和path.resolve()，很多人以为它们功能相同，实际上两者的行为差异相当明显。path.join()的作用很纯粹：把传入的所有片段按顺序连接起来，并对结果做一次规范化，它会用当前系统的分隔符连接片段。而path.resolve()的行为更像是Shell里的cd命令，它从右到左依次处理参数，遇到绝对路径就停下，最终把结果解析为一个绝对路径。
两者的区别通过代码看最直观。在Linux环境下运行下面的例子，观察输出差异：
const path = require('path');
// join只做拼接加规范化
console.log(path.join('/foo', 'bar', 'baz')); // /foo/bar/baz
console.log(path.join('/foo', '/bar', 'baz')); // /foo/bar/baz
// resolve会解析成绝对路径，遇到绝对路径片段会截断
console.log(path.resolve('/foo', 'bar', 'baz')); // /foo/bar/baz
console.log(path.resolve('bar', 'baz')); // /home/user/bar/baz（取决于cwd）
console.log(path.resolve('/foo', '/bar', 'baz')); // /bar/baz 注意这里被截断了从上面的输出可以看出，join不管片段是相对还是绝对，一律按顺序拼接；而resolve一旦在中间遇到绝对路径片段（如/bar），前面的片段会被直接丢弃。这是一个非常典型的坑：如果你期望得到/foo/bar/baz，结果却拿到了/bar/baz，多半就是把这两个方法用混了。实践中的建议是，单纯拼接路径片段用join，需要得到基于某个基准目录的绝对路径时再用resolve。
另外补充一个细节，join和resolve都允许传入零个参数或空字符串。path.join('foo', '', 'bar')会返回foo/bar，空片段会被忽略；而path.resolve()不带任何参数时返回当前工作目录，等价于process.cwd()。如果传入的类型不是字符串，两个方法都会抛出TypeError，这在动态拼接路径时要格外小心，比如从配置文件读取的值可能是undefined，直接传进去就会崩。
二、路径解析：用parse和basename拆解路径结构
拿到一个完整路径后，经常需要从中提取文件名、扩展名或者所在目录，path模块为此提供了一组细粒度的方法。path.basename()返回路径中最后一段，path.extname()返回扩展名（含点号），path.dirname()返回目录部分。这三个方法日常使用频率很高，尤其是在处理上传文件、生成目标文件名等场景。
const path = require('path');
const filePath = '/home/user/project/index.test.js';
console.log(path.basename(filePath)); // index.test.js
console.log(path.basename(filePath, '.js')); // index.test 去掉指定后缀
console.log(path.extname(filePath)); // .js
console.log(path.dirname(filePath)); // /home/user/project如果需要一次性拿到路径的所有组成部分，path.parse()是更合适的选择。它把路径拆成一个对象，包含root（根目录）、dir（完整目录）、base（含扩展名的文件名）、ext（扩展名）和name（不含扩展名的文件名）五个字段。与它对应的反向操作是path.format()，可以把这类对象重新组装成路径字符串，两者配合可以实现灵活的路径改写。
const path = require('path');
const parsed = path.parse('/home/user/project/index.js');
console.log(parsed);
// {
// root: '/',
// dir: '/home/user/project',
// base: 'index.js',
// ext: '.js',
// name: 'index'
// }
// 修改文件名后重新组装
parsed.name = 'main';
console.log(path.format(parsed)); // /home/user/project/main.js值得注意的是，extname对隐藏文件的处理有些特殊：path.extname('.gitignore')返回的是空字符串，因为以点开头的文件被视为没有扩展名的隐藏文件；而path.extname('file.tar.gz')返回的是.gz，只取最后一个点之后的部分。如果业务上需要识别.tar.gz这类复合扩展名，就得自己写判断逻辑，不能依赖extname。另外basename的第二个参数去掉后缀时是精确匹配，path.basename('index.js', '.txt')不会生效，仍返回完整的index.js。
三、路径规范化：normalize、sep与跨平台处理
路径规范化的核心方法是path.normalize()，它会处理路径中的多余分隔符、.和..片段。比如path.normalize('/foo/bar//baz/./quux/..')的结果是/foo/bar/baz。这个方法在接收用户输入或拼接来自外部数据源的路径时特别有用，可以先把杂乱的路径清理干净再做后续处理。
const path = require('path');
console.log(path.normalize('/foo/bar//baz/./quux/..')); // /foo/bar/baz
console.log(path.normalize('a/b/c/../d')); // a/b/d
// Windows平台下的表现
console.log(path.win32.normalize('C:\\temp\\\\foo\\bar\\..\\')); // C:\temp\foo\
console.log(path.posix.normalize('C:\\temp\\foo')); // C:\temp\foo（posix下反斜杠只是普通字符）这里需要引出path模块的跨平台设计。直接require('path')拿到的是根据当前操作系统自动选择的实现，Windows上等于path.win32，Linux和macOS上等于path.posix。如果你在写需要处理两种格式路径的工具（比如一个部署在Linux上但解析Windows路径的脚本），可以直接使用path.win32或path.posix这两个子模块，方法签名完全一致。分隔符则可以通过path.sep获取，Windows上是反斜杠，类Unix系统上是斜杠，path.delimiter返回环境变量PATH的分隔符，Windows上是分号，Linux上是冒号。
还有一个高频场景值得单独说明：获取当前模块所在目录。ESM和CommonJS的写法不同，CommonJS中用__dirname这个全局变量，ESM中由于该变量被移除，需要借助import.meta.url转换：
import { fileURLToPath } from 'node:url';
import path from 'node:path';
const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
// 拼接出数据文件的绝对路径
const dataFile = path.join(__dirname, 'data', 'config.json');最后提醒一个容易踩的坑：path.normalize并不校验路径是否真实存在，它只做字符串层面的清理，也不负责把相对路径转成绝对路径。另外，如果路径片段以..开头且超出了根目录，比如path.normalize('/../foo')，结果会规整为/foo，多余的..被直接丢弃。在涉及安全性的场景中（比如根据用户输入读取文件），仅靠normalize防止路径穿越是不够的，建议先用path.resolve得到绝对路径，再校验它是否落在允许的基准目录之内，这样才能真正避免目录穿越攻击。
总结一下，path模块虽然API不多，但每个方法都有明确的适用边界：拼片段用join，求绝对路径用resolve，拆结构用parse，清理乱路径用normalize，跨平台场景记得切换win32和posix。把这些细节吃透，写出来的文件操作代码会在稳定性和可移植性上明显提升一个档次。