rename 不是 C++ 标准库函数，而是 C 标准库 <cstdio> 中的函数，行为受操作系统限制：跨文件系统失败、Windows 下不覆盖已存在文件，且需手动检查返回值与 errno。
直接说结论：rename 在 C++ 中不是 C++ 标准库函数，而是来自 C 标准库 <cstdio>（或 C 头文件 <stdio.h>），它在绝大多数系统上可用，但行为受操作系统限制——跨文件系统重命名会失败，且不支持覆盖已存在目标文件（Windows 下尤其容易出错）。
为什么 rename 有时返回 -1 或失败？
这不是代码写错了，而是底层系统调用被拒绝了。常见原因有：
-
rename不是原子操作跨磁盘/分区：源路径和目标路径必须在同一个挂载点下，否则返回-1，errno通常是EXDEV - 目标文件已存在：Linux/macOS 会静默覆盖，Windows 直接失败（
errno = EACCES或EEXIST） - 权限不足：对源目录或目标目录缺少写权限
- 路径含中文或特殊字符：未正确转为当前 locale 编码（尤其 Windows 控制台默认 GBK）
怎么安全地用 rename 替代“移动+覆盖”逻辑？
别指望 rename 自动处理冲突，得自己补判断和清理：
- 先用
std::filesystem::exists（C++17）检查目标路径是否已存在；若存在，按需std::filesystem::remove（注意权限和只读属性） - 调用
rename后必须检查返回值：if (rename(old_path.c_str(), new_path.c_str()) != 0) { /* 处理 errno */ } - Windows 下建议用
_wrename+std::wstring避免编码问题，而非rename+std::string - 不要传入空字符串、相对路径未展开、或含尾部斜杠的路径（如
"dir/"），rename对这些行为未定义
C++17 std::filesystem::rename 和 C 的 rename 有什么区别？
前者是后者封装，但多了几处关键差异：
立即学习“C++免费学习笔记（深入）”；
- 抛异常而非返回错误码：失败时抛
std::filesystem::filesystem_error，更易捕获具体原因 - 自动处理路径标准化（如
"./a/../b"→"b"），C 版本完全不管 - 跨平台语义一致：Windows 下也能覆盖目标（只要权限允许），不像 C 版本依赖 CRT 实现
- 性能略低：每次调用都做路径解析和权限检查，高频重命名场景需权衡
示例（C++17）：
try { std::filesystem::rename("old.txt", "new.txt"); } catch (const std::filesystem::filesystem_error& e) { /* e.code().message() 可查具体错误 */ }
真正麻烦的从来不是调用那行代码，而是没意识到 rename 的成败取决于目录权限、文件系统边界、编码环境这三个变量——它们不在编译期报错，只在某个用户某台机器某个时间点突然失效。
