path.resolvesibling() 是 node.js v20.0.0+ 新增方法，用于直接定位与当前路径同级的文件或目录，自动提取父目录并拼接目标名，支持纯文件名、子目录及以 ../ 开头的相对路径，不校验存在性。
Path.resolveSibling() 是 Node.js 中 path 模块（自 v20.0.0 起）新增的实用方法，专为快速定位**与当前路径同级**的其他文件或目录而设计。它省去了手动拼接父路径再加入新名称的步骤，让代码更简洁、不易出错。
核心作用：跳过 parent 目录拼接，一步到位
传统方式要找同级资源，得先用 path.dirname() 获取父目录，再用 path.join() 拼上目标名：
const path = require('path');
const current = '/project/src/utils/logger.js';
const sibling = path.join(path.dirname(current), 'config.json'); // → '/project/src/utils/config.json'
而 resolveSibling() 直接在当前路径“旁边”定位：
const sibling = path.resolveSibling(current, 'config.json'); // 同样 → '/project/src/utils/config.json'
它会自动提取当前路径的父目录，再把传入的名称作为子项加入——逻辑清晰，语义明确。
支持相对路径和多种输入形式
第二个参数可以是任意合法路径片段，包括：
- 纯文件名：
path.resolveSibling('/a/b/c.js', 'd.json')→/a/b/d.json - 带子目录的路径：
path.resolveSibling('/a/b/c.js', 'data/cache.txt')→/a/b/data/cache.txt - 以
../开头的相对路径（仍以同级为起点）：path.resolveSibling('/a/b/c.js', '../shared/README.md')→/a/shared/README.md - 绝对路径会被忽略前缀，按规则处理（不推荐混用）
实际使用场景示例
在模块开发或配置加载中特别顺手：
-
读取同级 JSON 配置：
const configPath = path.resolveSibling(import.meta.url, '../config.json');
（注意：ESM 中import.meta.url是 file:// URL，需先用fileURLToPath()转成路径） -
定位同级模板或样式文件：
const template = path.resolveSibling(__filename, 'template.hbs'); -
构建多语言资源路径：
const localeDir = path.resolveSibling(__dirname, '../locales');
注意事项
- 仅适用于 Node.js ≥ v20.0.0；旧版本可用
path.join(path.dirname(p), name)替代 - 若当前路径是根目录（如
'/'或'C:\'），则 sibling 就是该根下的直接子项 - 不校验目标是否存在，只是路径计算 —— 后续读写仍需自行判断或捕获错误
