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
将配置文件内容设为:
{
"outputDir": "dist"
}
outputDir 表示清单生成后的保存目录。这里先验证能读到配置,不执行清单生成。
只写相对路径,会随启动目录改变查找位置
把下面内容保存为 scripts/read-config.mjs:
import { readFileSync } from 'node:fs'
console.log(readFileSync('./config.json', 'utf8'))
这里提前使用下一篇的 readFileSync:它读取指定文件,utf8 让结果以文本返回。重点看两种启动方式的区别:
| 终端当前位置 | 执行命令 | 实际查找位置与结果 |
|---|---|---|
project/scripts | node read-config.mjs | 读取 scripts/config.json,输出配置文本 |
project | node scripts/read-config.mjs | 查找根目录的 config.json,不存在时报告 ENOENT |
脚本没有移动,变化的是终端目录。readFileSync 接收相对路径字符串时,以 process.cwd() 为起点;改成 path.resolve('./config.json') 也仍然依赖这个起点。
按脚本位置读取,启动方式就不再影响结果
将脚本替换为:
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,再输出它的绝对路径、文件名与扩展名。
// 请在这里编写代码
🎉 现在可以用自己的例子验证这些用法啦!
