Node.js path 模塊

path 模塊是一個內(nèi)置模塊胖替,可幫助您以獨立于操作系統(tǒng)的方式使用文件系統(tǒng)路徑塞耕。如果要構(gòu)建支持 OSX陆淀、Linux 和 Windows 的 CLI 工具哗咆,則 path 模塊是必不可少的咽扇。

即使您正在構(gòu)建一個只在 Linux 上運行的后端服務(wù),path 模塊仍然有助于在操作路徑時避免邊緣情況洁段。

下面我們來介紹 path 模塊的基本用法,以及為什么您應(yīng)該使用 path 模塊而不是將路徑操縱成字符串共郭。

在 Node 中使用 path 模塊

path 模塊中最常用的方法是 path.join()祠丝。該方法將一個或多個路徑段合并為一個字符串,如下所示:

const path = require('path')

path.join('/path', 'to', 'test.txt') // '/path/to/test.txt'

您可能想知道為什么要使用 path.join() 方法而不是字符串拼接除嘹。

'/path' + '/' + 'to' + '/' + 'test.txt' // '/path/to/test.txt'
['/path', 'to', 'test.txt'].join('/') // '/path/to/test.txt'

原因主要有兩個:

  • 對于 Windows 支持写半。Windows 使用反斜杠(\)而不是正斜杠(/)作為路徑分隔符。path.join() 會為我們處理此問題尉咕。因為 path.join('data', 'test.txt') 在 Linux 和 OSX 以及 Windows 上都會返回 'data/test.txt'叠蝇。
  • 用于處理邊緣情況。使用文件系統(tǒng)路徑時年缎,會彈出許多邊緣情況悔捶。例如,如果您嘗試手動連接兩個路徑单芜,您可能會意外地得到重復(fù)的路徑分隔符蜕该。path.join() 方法為我們處理開頭和結(jié)尾的斜杠,如下所示:
path.join('data', 'test.txt') // 'data/test.txt'
path.join('data', '/test.txt') // 'data/test.txt'
path.join('data/', 'test.txt') // 'data/test.txt'
path.join('data/', '/test.txt') // 'data/test.txt'

常用的 path 方法

path 模塊還具有幾個用于提取路徑組件的方法洲鸠,例如文件擴展名或目錄堂淡。

path.extname() 方法以字符串形式返回文件擴展名:

path.extname('/path/to/test.txt') // '.txt'

就像連接兩條路徑一樣,獲取文件擴展名比最初看起來要復(fù)雜扒腕。

如果 path. 為結(jié)尾绢淀,將返回 .。如果文件無擴展名瘾腰,又不以 . 結(jié)尾皆的,或文件沒有擴展名,將返回空值居灯。

path.extname('/path/to/index.') // '.'
path.extname('/path/to/README') // ''
path.extname('/path/to/.gitignore') // ''

path 模塊還有 path.basename()path.dirname() 方法祭务,分別獲取文件名(包括擴展名)和目錄。

path.basename('/path/to/test.txt') // 'test.txt'
path.dirname('/path/to/test.txt') // '/path/to'

path.parse() 方法返回一個對象怪嫌,該對象包含分為五個不同組合的路徑义锥,包括擴展名和目錄。path.parse() 方法也是不帶任何擴展名獲取文件名的方法岩灭。

path.parse('/path/to/test.txt')

/*
{
  root: '/',
  dir: '/path/to',
  base: 'test.txt',
  ext: '.txt',
  name: 'test'
}
*/

使用 path.relative()

path.join()path.extname() 這樣的方法涵蓋了大多數(shù)使用文件路徑的用例拌倍。但是 path 模塊有幾個更高級的方法,例如 path.relative()

path.relative(from, to) 方法根據(jù)當前工作目錄返回從 fromto 的相對路徑柱恤。 如果 fromto 都解析為相同的路徑(在分別調(diào)用 path.resolve() 之后)数初,則返回零長度字符串。

// 返回相對于第一條路徑的第二條路徑的路徑
path.relative('/app/views/home.html', '/app/layout/index.html') // '../../layout/index.html'

如果給定了相對于一個目錄的路徑梗顺,但需要相對于另一個目錄的路徑泡孩,則 path.relative() 方法非常有用。例如寺谤,流行的文件系統(tǒng)監(jiān)視庫 Chokidar 提供了相對于監(jiān)視目錄的路徑仑鸥。

const watcher = chokidar.watch('mydir')

// 如果用戶添加 mydir/path/to/test.txt,則會打印 mydir/path/to/test.txt
watcher.on('add', path => console.log(path))

這就是為什么大量的使用 Chokidar 工具变屁。如常見的 Gatsby 或 webpack眼俊,其在內(nèi)部也大量使用 path.relative() 方法。

例如粟关,Gatsby 使用 path.relative() 方法幫助同步靜態(tài)文件目錄疮胖。

export const syncStaticDir = (): void => {
  const staticDir = nodePath.join(process.cwd(), `static`)
  chokidar
    .watch(staticDir)
    .on(`add`, (path) => {
      const relativePath = nodePath.relative(staticDir, path)
      fs.copy(path, `${process.cwd()}/public/${relativePath}`)
    })
    .on(`change`, (path) => {
      const relativePath = nodePath.relative(staticDir, path)
      fs.copy(path, `${process.cwd()}/public/${relativePath}`)
    })
}

現(xiàn)在,假設(shè)用戶向 static 目錄添加了一個新文件 main.js闷板。Chokidar 調(diào)用 on('add') 事件處理程序澎灸,路徑設(shè)置為 static/main.js。但是遮晚,當您將文件復(fù)制到 /public 時击孩,不需要額外的 static/

調(diào)用 path.relative('static', 'static/main.js') 返回 static/main.js 相對于 static 的路徑鹏漆,這正是您想要將 static 的內(nèi)容復(fù)制到 public 的路徑巩梢。

跨操作系統(tǒng)路徑和 URL

默認情況下,path 模塊會根據(jù) Node 進程運行的操作系統(tǒng)自動在 POSIX(OSX艺玲、Linux)和 Windows 模式之間切換括蝠。

但是,path 模塊確實可以在 POSIX 上使用 Windows path 模塊饭聚,反之亦然忌警。path.posixpath.win32 屬性分別包含 path 模塊的 Posix 和 Windows 版本。

// 返回 'path\to\test.txt'秒梳,與操作系統(tǒng)無關(guān)
path.win32.join('path', 'to', 'test.txt')

// 返回 'path/to/test.txt'法绵,與操作系統(tǒng)無關(guān)
path.posix.join('path', 'to', 'test.txt')

在大多數(shù)情況下,根據(jù)檢測到的操作系統(tǒng)自動切換 path 模塊是正確的行為酪碘。但是朋譬,使用 path.posixpath.win32 屬性對于總是希望輸出 Windows 或 Linux 樣式路徑的測試或應(yīng)用程序可能會有所幫助。

例如兴垦,一些應(yīng)用程序使用 path.join()path.extname() 等方法處理 URL 路徑徙赢。

// 'https://api.mydomain.app/api/v2/me'
'https://api.mydomain.app/' + path.join('api', 'v2', 'me')

這種方法適用于 Linux 和 OSX字柠,但如果有人試圖將您的應(yīng)用程序部署到一些無服務(wù)器上會發(fā)生什么?

你最終會得到 https://api.mydomain.app/api\v2\me狡赐,這不是有效的 URL窑业!如果使用 path 模塊操作 URL,則應(yīng)使用 path.posix枕屉。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末常柄,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子搀擂,更是在濱河造成了極大的恐慌拐纱,老刑警劉巖,帶你破解...
    沈念sama閱讀 206,311評論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件哥倔,死亡現(xiàn)場離奇詭異,居然都是意外死亡揍庄,警方通過查閱死者的電腦和手機咆蒿,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,339評論 2 382
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來蚂子,“玉大人沃测,你說我怎么就攤上這事∈尘ィ” “怎么了蒂破?”我有些...
    開封第一講書人閱讀 152,671評論 0 342
  • 文/不壞的土叔 我叫張陵,是天一觀的道長别渔。 經(jīng)常有香客問我附迷,道長,這世上最難降的妖魔是什么哎媚? 我笑而不...
    開封第一講書人閱讀 55,252評論 1 279
  • 正文 為了忘掉前任喇伯,我火速辦了婚禮,結(jié)果婚禮上拨与,老公的妹妹穿的比我還像新娘稻据。我一直安慰自己,他們只是感情好买喧,可當我...
    茶點故事閱讀 64,253評論 5 371
  • 文/花漫 我一把揭開白布捻悯。 她就那樣靜靜地躺著,像睡著了一般淤毛。 火紅的嫁衣襯著肌膚如雪今缚。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,031評論 1 285
  • 那天低淡,我揣著相機與錄音荚斯,去河邊找鬼。 笑死,一個胖子當著我的面吹牛事期,可吹牛的內(nèi)容都是我干的滥壕。 我是一名探鬼主播,決...
    沈念sama閱讀 38,340評論 3 399
  • 文/蒼蘭香墨 我猛地睜開眼兽泣,長吁一口氣:“原來是場噩夢啊……” “哼绎橘!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起唠倦,我...
    開封第一講書人閱讀 36,973評論 0 259
  • 序言:老撾萬榮一對情侶失蹤称鳞,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后稠鼻,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體冈止,經(jīng)...
    沈念sama閱讀 43,466評論 1 300
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 35,937評論 2 323
  • 正文 我和宋清朗相戀三年候齿,在試婚紗的時候發(fā)現(xiàn)自己被綠了熙暴。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 38,039評論 1 333
  • 序言:一個原本活蹦亂跳的男人離奇死亡慌盯,死狀恐怖周霉,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情亚皂,我是刑警寧澤俱箱,帶...
    沈念sama閱讀 33,701評論 4 323
  • 正文 年R本政府宣布,位于F島的核電站灭必,受9級特大地震影響狞谱,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜禁漓,卻給世界環(huán)境...
    茶點故事閱讀 39,254評論 3 307
  • 文/蒙蒙 一芋簿、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧璃饱,春花似錦与斤、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,259評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至谒撼,卻和暖如春食寡,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背廓潜。 一陣腳步聲響...
    開封第一講書人閱讀 31,485評論 1 262
  • 我被黑心中介騙來泰國打工抵皱, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留善榛,地道東北人。 一個月前我還...
    沈念sama閱讀 45,497評論 2 354
  • 正文 我出身青樓呻畸,卻偏偏與公主長得像移盆,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子伤为,可洞房花燭夜當晚...
    茶點故事閱讀 42,786評論 2 345

推薦閱讀更多精彩內(nèi)容

  • 一咒循、簡介 path 模塊包含了一套用于處理和轉(zhuǎn)換文件路徑的工具集。差不多所有的方法只是對字符串進行變換绞愚,而不是調(diào)用...
    聆昕閱讀 407評論 0 0
  • Node.js path 模塊提供了一些用于處理文件路徑的小工具叙甸,我們可以通過以下方式引入該模塊: 對window...
    女王陛下的喵閱讀 289評論 0 1
  • nodejs中的內(nèi)置模塊有很多比如fs,http,path,url,等等 引入path模塊 const path...
    聽風且雨行閱讀 164評論 0 0
  • 簡介 模塊描述: 用于處理文件路徑及目錄路徑的一個nodejs內(nèi)置模塊常用功能:路徑的解析(path.parse(...
    玉沐丶閱讀 403評論 0 0
  • path 模塊的默認操作會根據(jù) Node.js 應(yīng)用程序運行的操作系統(tǒng)的不同而變化位衩。 比如裆蒸,當運行在 Window...
    EdmundChen閱讀 399評論 0 0