Node.js路径处理模块path详解

作者：终端旅客时间：2026-10-22 04:25:15浏览：588

本文深入解析Node.js内置path模块，涵盖文件路径提取、分隔符识别、路径规范化及绝对路径解析等核心功能。通过dirname、basename、extname、normalize、join和resolve等方法的实际代码示例，帮助开发者掌握跨平台路径处理的正确姿势。

Node.js路径处理模块path详解

前言

path模块提供了一系列用于处理和转换文件路径的工具函数，开发者可以通过 require('path') 引入并使用该模块。本文将对该模块的功能进行详细解析。

路径组成部分解析

【path.dirname(p)】

该函数用于返回指定路径 p 所在的目录。


var path = require('path');
console.log(path.dirname('/foo/bar/baz/asdf/a.txt')); // /foo/bar/baz/asdf
console.log(path.dirname('/foo/bar/baz/asdf/')); // /foo/bar/baz
console.log(path.dirname('C:/test/aaa')); // C:/test

【path.basename(p[, ext])】

此方法返回路径 p 的最后一部分，通常指文件名。若提供可选参数 ext，则会在返回结果中截去指定的后缀内容。


var path = require('path');
console.log(path.basename('/foo/bar/baz/asdf/a.txt')); // a.txt
console.log(path.basename('/foo/bar/baz/asdf/a.txt','.txt')); // a
console.log(path.basename('/foo/bar/baz/asdf/')); // asdf
console.log(path.basename('C:/test/aaa')); // aaa

【path.extname(p)】

该方法返回路径 p 的文件扩展名，即从最后一个 '.' 字符到字符串末尾的部分。如果路径的最后一部分不包含 '.'，或者路径以 '.' 开头，则返回空字符串。


var path = require('path');
console.log(path.extname('/foo/bar/baz/asdf/a.txt')); // .txt
console.log(path.extname('/foo/bar/baz/asdf/a.txt.b')); // .b
console.log(path.extname('/foo/bar/baz/asdf/a.')); // .
console.log(path.extname('C:/test/aaa/.')); // ''
console.log(path.extname('C:/test/aaa')); // ''

分隔符相关属性

【path.sep】

返回当前操作系统平台下的文件分隔符。在 Windows 系统中为 '\'，而在类 Unix（*nix）系统中为 '/'。


var path = require('path');
console.log(path.sep); // win下为\，*nix下为/
console.log('foo\\bar\\baz'.split(path.sep)); // [ 'foo', 'bar', 'baz' ]
console.log('foo/bar/baz'.split(path.sep)); // win下返回['foo/bar/baz']，但在*nix系统下会返回['foo','bar','baz']

【path.delimiter】

返回当前操作系统平台下的路径分隔符。在 Windows 系统中为 ';'，而在类 Unix（*nix）系统中为 ':'。


var path = require('path');
console.log(path.delimiter); //win下为“;”，*nix下为“:”
console.log(path.sep); // win下为\，*nix下为/

路径规范化处理

【path.normalize(p)】

该方法用于规范化路径字符串，主要处理冗余的 '..'、'.' 以及多个连续斜杠。当检测到多个斜杠时，会被替换为单个斜杠；若路径末尾包含斜杠，则予以保留。在 Windows 系统下，结果将使用反斜杠。


var path = require('path');
console.log(path.normalize('a/b/c/../user/bin'));//a\b\user\bin
console.log(path.normalize('a/b/c///../user/bin/'));//a\b\user\bin\
console.log(path.normalize('a/b/c/../../user/bin'));//a\user\bin
console.log(path.normalize('a/b/c/.././///../user/bin/..'));//a\user
console.log(path.normalize('a/b/c/../../user/bin/../../'));//a\
console.log(path.normalize('a/../../user/bin/../../'));//..\
console.log(path.normalize('a/../../user/bin/../../../../'));//..\..\..\
console.log(path.normalize('./a/.././user/bin/./'));//user\bin\

【path.join([path1], [path2], [...])】

此函数将多个路径字符串拼接在一起，并自动转换为规范化后的路径格式。


var path = require('path');
console.log(path.join('////./a', 'b////c', 'user/'));//\a\b\c\user
console.log(path.join('a', '../../', 'user/'));//..\user\

绝对路径与相对路径处理

【path.resolve([from ...], to)】

该方法用于计算从源地址 from 到目的地址 to 的绝对路径，其行为类似于在 Shell 中连续执行一系列 cd 命令。


path.resolve('foo/bar', '/tmp/file/', '..', 'a/../subfile')

具体逻辑如下：


cd foo/bar
cd /tmp/file/
cd ..
cd a/../subfile
pwd

[注意] 如果传入的 from 或 to 参数中包含绝对路径（例如 'E:/abc' 或以 '/' 开头的路径），则之前的所有 from 参数将被忽略。


var path = require('path');
console.log(path.resolve('.', 'testFiles/..', 'trdLayer'));//D:\project\trdLayer
console.log(path.resolve('..', 'testFiles', 'a.txt'));//D:\testFiles\a.txt
console.log(path.resolve('D:', 'abc', 'D:/a'));//D:\a
console.log(path.resolve('abc', 'ok.gif'));//D:\project\abc\ok.gif
console.log(path.resolve('abc', '..', 'a/../subfile')); //D:\project\subfile

【path.isAbsolute(path)】

判断传入的 path 是否为绝对路径。如果路径以驱动盘符开头（如 'E:/abc'）或以 '/' 开头，则返回 true。


var path = require('path');
console.log(path.isAbsolute('../testFiles/secLayer'));//false
console.log(path.isAbsolute('./join.js'));//false
console.log(path.isAbsolute('temp'));//false
console.log(path.isAbsolute('/temp/../..'));//true
console.log(path.isAbsolute('E:/github/nodeAPI/abc/efg'));//true
console.log(path.isAbsolute('///temp123'));//true

【path.relative(from, to)】

该方法用于计算从 from 到 to 的相对路径，可以视为 path.resolve 的反向操作。


path.resolve(from, path.relative(from, to)) == path.resolve(to)

var path = require('path');
console.log(path.relative('C:\\\test', 'C:\\\impl\\bbb'));//..\impl\bbb
console.log(path.relative('C:/test/aaa', 'C:/bbb'));//..\..\bbb
console.log(path.relative('C:/test/aaa', 'D:/bbb'));//D:\bbb

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持本站。

作者最新文章

Java和JavaScript的应用场景分工：后端企业级开发与Web前端交互

2026-11-05 15:57:34

除了浏览器和Node.js，还有哪些轻量级Js脚本运行工具？

2026-11-04 17:38:24

无需后端：用JavaScript实现简单网站的本地数据存储

2026-11-03 23:03:30

Node.js 下载慢或官网打不开怎么办

2026-11-03 18:19:37

JS解析大体积Excel文件内存溢出怎么办

2026-11-03 18:19:37