Path.resolveSibling 不是 Node.js 标准 API，实际需用 path.dirname() + path.join() 构造同级路径，再调用 fs.rename() 完成重命名，注意目录存在性与跨设备限制。
Path.resolveSibling 并不是 Node.js 标准 API 中的方法，它并不存在于 path 模块（如 path.resolve、path.join）或 fs 模块中。因此，**无法直接通过 Path.resolveSibling 实现任何文件操作逻辑**——因为它根本不存在。
常见误解来源
这个名称容易让人联想到以下两种真实存在的能力，但需明确区分：
-
Java NIO 的
resolveSibling()：这是java.nio.file.Path接口的方法，用于基于当前路径解析“同级”路径（即替换最后一级路径名）。Node.js 中没有对应物。 -
误记或混淆了 Node.js 的
path.resolve()或path.dirname()+path.join()：实际在 Node.js 中构造同级路径，需手动获取父目录，再拼接新文件名。
在 Node.js 中正确实现“同级目录下重命名变量文件”
假设你有一个源文件 /project/src/config.js，想将其重命名为同级的 config.prod.js，核心是：先得到父目录，再组合新文件名。
- 用
path.dirname(filepath)获取上级目录路径 - 用
path.basename(filepath, ext)提取无扩展名的文件名（可选） - 用
path.join(dir, newBasename + newExt)构造目标路径 - 调用
fs.rename()或fs.promises.rename()执行重命名
示例代码（ESM + Promise）：
import * as path from 'node:path';
import * as fs from 'node:fs/promises';
<p>const source = '/project/src/config.js';
const targetName = 'config.prod.js';</p><p>const parentDir = path.dirname(source);
const target = path.join(parentDir, targetName);</p><p>await fs.rename(source, target);
console.log(<code>已重命名为: ${target}</code>);
封装成可复用的“同级重命名”函数
若需动态生成同级新名（比如加后缀、改扩展名），可封装如下：
- 接受源路径和一个生成新文件名的函数（如
(name, ext) => `${name}.backup${ext}`） - 自动提取基础名与扩展名，避免硬编码字符串拼接
- 支持同步/异步，返回新路径便于链式处理
简易封装示例：
function resolveSibling(filepath, newNameFn) {
const dir = path.dirname(filepath);
const base = path.basename(filepath);
const name = path.parse(base).name;
const ext = path.parse(base).ext;
const newBase = typeof newNameFn === 'function'
? newNameFn(name, ext)
: newNameFn;
return path.join(dir, newBase);
}
<p>// 使用
const newTarget = resolveSibling('/a/b/data.json', (n, e) => <code>${n}.v2${e}</code>);
// → '/a/b/data.v2.json'
注意事项
- 确保目标路径所在目录已存在，否则
fs.rename()会报错（ENOENT）；必要时用fs.mkdir(..., { recursive: true }) - 重命名跨设备（如不同磁盘分区）在部分系统上不被支持，此时需用
fs.copyFile()+fs.unlink() - Windows 对文件名大小写不敏感，但 Node.js 路径操作仍按字面匹配，请保持一致性
