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

作者:终端旅客

时间:2026-10-22

浏览:587

本文深入解析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

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

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章