直接用 fs.rename() 会失败，根本原因是其不支持跨设备（如不同磁盘/分区）重命名，触发 exdev 错误；且若传入相对路径，解析依赖当前工作目录（如 vscode 启动路径），易导致 enoent；必须用绝对路径，并对跨设备场景改用 fs.copyfile() + fs.unlink() 组合。
为什么直接用 fs.rename() 会失败？
常见错误是调用 fs.rename() 后文件没动，甚至报 ENOENT 或 EXDEV。根本原因不是写法错，而是路径没 resolve —— 你传的相对路径（比如 "old.txt"）会被解析成当前工作目录下的路径，而 VSCode 启动时的工作目录不一定是你的项目根目录，尤其在通过右键菜单或命令面板触发时。更麻烦的是跨设备重命名（比如从 /home 移到 /mnt/usb）在 Linux/macOS 下会直接失败，fs.rename() 不支持。
- 务必用
path.resolve(__dirname, "old.txt")或path.join(process.cwd(), "old.txt")显式构造绝对路径 - 跨分区/磁盘重命名必须拆成
fs.copyFile()+fs.unlink()，不能只靠fs.rename() - Windows 下大小写不敏感，但 Node.js 的
fs.rename()仍会把A.txt→a.txt当作不同文件处理，可能意外覆盖
如何让重命名逻辑响应 VSCode 右键菜单？
VSCode 本身不提供“选中文件 → 右键 → 重命名”原生扩展点，得自己注册一个 command，再通过 package.json 的 menus 节点绑定到资源管理器上下文。关键不是写函数，而是正确声明作用域和启用条件。
- 在
package.json的contributes.menus里加："explorer/context": [{ "when": "resourceExtname == '.js' || resourceExtname == '.ts'", "command": "extension.renameFile", "group": "navigation" }] -
when条件必须用resourceExtname，不是resourceFilename—— 后者匹配整个文件名（含扩展名），前者才只取扩展名做判断 - 命令回调里拿到的
uri是vscode.Uri对象，需调用uri.fsPath才能得到真实文件路径（注意 Windows 下是反斜杠，建议统一用path.normalize()）
怎么安全地生成新文件名而不覆盖旧文件？
用户输入新名字时，最常踩的坑是没检查目标路径是否已存在，导致静默覆盖。Node.js 的 fs.access() 或 fs.stat() 必须同步或 await 判断，且要考虑目录层级——比如想把 a.js 改成 dir/b.js，得先确认 dir/ 是否存在。
- 用
await fs.access(newPath, fs.constants.F_OK)检查路径是否存在，比try/catch更轻量 - 如果新路径含目录（如
"src/utils/new.js"），需逐级创建：先path.dirname(newPath)，再fs.mkdirSync(..., { recursive: true }) - 避免用
Date.now()或随机数拼接默认名（如file_1712345678.js），用户无法预期；建议 fallback 到originalName + "_copy"这类语义化后缀
为什么重命名后 VSCode 不刷新资源管理器？
Node.js 层改完文件，VSCode 不知道文件系统变了，资源管理器仍显示旧名。这不是 bug，是设计：VSCode 默认监听文件系统事件有延迟，且某些场景（如远程开发、WSL）下 inotify 不可靠。必须主动通知。
- 执行完重命名后，调用
vscode.workspace.fs.delete(oldUri, { recursive: false })和vscode.workspace.fs.copy(newUri, oldUri, { overwrite: true })并不能刷新视图 - 正确做法是触发一次文件变更事件：
vscode.workspace.onDidChangeFiles(() => {}, null, disposables);不起作用；实际要发一个 fake change：vscode.workspace.fs.readFile(newUri)无意义，真正有效的是vscode.window.showTextDocument()再 close —— 但太重 - 最简方案：调用
vscode.commands.executeCommand("workbench.files.action.refreshFilesExplorer")，强制刷新资源管理器（注意这命令名固定，不能缩写）
跨平台路径处理、VSCode 文件事件机制、用户输入校验这三块最容易漏，写的时候别只盯着 rename 函数本身。
