path 路径处理模块:拼接、定位与文件名提取

组合文件路径、提取文件名,并区分当前工作目录与模块目录。

🎯 引言

学完这篇文章,你能组合文件路径、提取文件名,并区分当前工作目录与模块目录。


🧱 path 按操作系统规则处理路径

node:path 是 Node.js 内置的路径处理模块。它计算路径字符串,不会创建文件,也不会检查结果是否存在。

创建 paths.mjs,先写入下面的导入语句,后面的小例子可以逐个追加并用 node paths.mjs 观察:

import path from 'node:path'

下文的绝对路径结果以 macOS/Linux 为例。Windows 常见绝对路径形如 C:\work\demo\note.txt,实际输出使用相应系统的规则。


🧩 join:把几段路径组合起来

目录和文件名来自不同变量时,用 join 拼接,避免自己处理路径分隔符:

console.log(path.join('data', 'note.txt'))

macOS/Linux 输出 data/note.txt,Windows 输出 data\note.txt。返回值是路径字符串;因为输入没有绝对起点,结果仍是相对路径。

join 会同时规范化路径:

console.log(path.join('data', '..', 'note.txt'))

输出 note.txt。


📍 resolve:得到完整的绝对路径

需要明确显示“程序将操作哪里”时,使用 resolve:

console.log(path.resolve('data', 'note.txt'))

假设终端当前目录是 /work/demo,结果为 /work/demo/data/note.txt。process.cwd() 可以查看这个当前目录;改变启动位置,结果也会跟着改变。

resolve 从右往左确定路径,遇到绝对路径就用它作为起点:

console.log(path.resolve('/work', '/tmp', 'note.txt'))

在 macOS/Linux 输出 /tmp/note.txt,前面的 /work 不再参与。

因此,join 适合组合路径片段,resolve 适合确定绝对位置;它们不是总能互换的两种拼接写法。


🏷️ 提取文件名和扩展名

只显示名称、不显示目录时,用 basename:

console.log(path.basename('data/note.txt'))

结果是 note.txt,返回值中保留扩展名。

想按扩展名做简单分类时,用 extname:

console.log(path.extname('data/note.txt'))

结果为 .txt,包含点号;没有扩展名时返回空字符串。扩展名只是名称的一部分,不能单靠它证明文件实际内容类型。

需要一次取得各个组成部分时,用 parse:

console.log(path.parse('data/note.txt'))

结果包含 root: ''、dir: 'data'、base: 'note.txt'、ext: '.txt'、name: 'note'。它们分别表示根位置、目录、完整文件名、扩展名和不含扩展名的文件名。这里根位置为空,因为输入是相对路径。


🪤 从其他目录启动,也能读取脚本自带的配置

脚本自带的配置文件,应按脚本位置查找,而不是按终端当前位置查找。 例如项目里有一个生成文件清单的脚本,它需要读取旁边的配置。你可能在项目根目录运行它,也可能进入脚本目录再运行;两种启动方式都应该读到同一份配置。

在项目中准备下面两个文件:

project/
└── scripts/
    ├── read-config.mjs
    └── config.json

将配置文件内容设为:

scripts/config.json
{
    "outputDir": "dist"
}

outputDir 表示清单生成后的保存目录。这里先验证能读到配置,不执行清单生成。

只写相对路径,会随启动目录改变查找位置

把下面内容保存为 scripts/read-config.mjs:

scripts/read-config.mjs
import { readFileSync } from 'node:fs'
console.log(readFileSync('./config.json', 'utf8'))

这里提前使用下一篇的 readFileSync:它读取指定文件,utf8 让结果以文本返回。重点看两种启动方式的区别:

终端当前位置执行命令实际查找位置与结果
project/scriptsnode read-config.mjs读取 scripts/config.json,输出配置文本
projectnode scripts/read-config.mjs查找根目录的 config.json,不存在时报告 ENOENT

脚本没有移动,变化的是终端目录。readFileSync 接收相对路径字符串时,以 process.cwd() 为起点;改成 path.resolve('./config.json') 也仍然依赖这个起点。

按脚本位置读取,启动方式就不再影响结果

将脚本替换为:

scripts/read-config.mjs
import { readFileSync } from 'node:fs'
const configUrl = new URL('./config.json', import.meta.url)
console.log(readFileSync(configUrl, 'utf8'))

import.meta.url 指向当前 read-config.mjs,因此 configUrl 始终指向它旁边的配置。文件 API 可以直接接收这个 URL 对象。

再次分别执行表格中的两条命令,都会输出配置文本,其中包含 "outputDir": "dist"。

配置、模板等文件随脚本一起保存时,用模块位置定位;脚本要处理用户当前目录里的文件时,才使用工作目录。 选择取决于文件属于哪一种情况,不是所有相对路径都要改写。


❓ 知识问答

Q1:join 和 resolve 怎么选?

组合目录与文件名用 join;需要得到绝对路径时用 resolve。两者都不会创建文件或检查文件是否存在。

Q2:为什么换个目录运行就读不到文件?

文件 API 的相对路径以工作目录为起点。读取脚本自带文件时,应根据 import.meta.url 定位。

Q3:文件名没有扩展名会怎样?

extname 返回空字符串,不代表文件不存在。


🧪 小练习

用 join 拼接 logs 和 app.log,再输出它的绝对路径、文件名与扩展名。

// 请在这里编写代码

🎉 现在可以用自己的例子验证这些用法啦!