路径

node:path 用于处理文件系统路径，和 URL 不是同一套语义。不要用字符串拼接路径。

import path from 'node:path'

path.join('src', 'server', 'index.js')
path.resolve('src', '../package.json')
path.basename('/app/config.json') // config.json
path.extname('config.json') // .json

常用 API

API	作用
join(...paths)	连接并规范化路径
resolve(...paths)	从右向左解析为绝对路径
relative(from, to)	计算相对路径
parse(path) / format(obj)	路径与组成对象互转
normalize(path)	规范化分隔符与 .、..
isAbsolute(path)	判断是否绝对路径

跨平台

默认 API 遵循当前操作系统。处理固定格式时显式使用 path.posix 或 path.win32。路径分隔列表使用 path.delimiter，不要写死 : 或 ;。

ESM 中加载相邻资源时优先使用 new URL('./file', import.meta.url)；只有需要文件系统字符串路径时再用 fileURLToPath() 转换。