std::filesystem::rename 是 C++17 起标准、跨平台、语义明确的重命名方式，不复制内容、速度快、同文件系统内原子性强；需注意源存在、目标不可预存、跨文件系统可能退化为复制删除、路径建议用 std::filesystem::path 构造。
std::filesystem::rename 是最直接的选择
从 C++17 开始，std::filesystem::rename 是标准、跨平台、语义明确的重命名方式。它不复制文件内容，只修改目录项，速度快且原子性强（在同文件系统内）。
使用前需包含头文件并启用 C++17 或更高标准：
#include <filesystem> // 编译时加 -std=c++17（GCC/Clang）或 /std:c++17（MSVC）
基本调用很简单：
std::filesystem::rename("old.txt", "new.txt");
但要注意几个关键点：
立即学习“C++免费学习笔记（深入）”；
-
std::filesystem::rename要求源路径存在，目标路径不能已存在（否则抛出std::filesystem::filesystem_error） - 若目标路径是已存在的目录，行为未定义（多数实现会失败）
- 跨文件系统重命名可能退化为“复制+删除”，此时不保证原子性，且可能因磁盘空间不足失败
- 路径可为相对或绝对；建议统一用
std::filesystem::path构造，避免手动拼接斜杠问题
rename() 系统调用适用于简单场景
如果项目不能用 C++17，或只需最小依赖，C 标准库的 rename() 仍是可靠选择。它在 POSIX 和 Windows（通过 CRT 兼容层）都可用。
典型用法：
if (rename("old.bin", "new.bin") != 0) {
// 失败：errno 可能是 ENOENT（源不存在）、EACCES（权限不足）、EXDEV（跨设备）
}
注意它的限制：
- 仅接受 C 风格字符串（
const char*），不支持宽字符或std::string_view - 错误靠全局
errno判断，多线程下需立即保存errno值 - Windows 下对正在被打开写入的文件调用会失败（
errno == EACCES），而std::filesystem::rename同样受限，这不是差异点 - 不支持路径中含 Unicode（在 Windows 的窄字符模式下会乱码）
处理目标文件已存在的情况
标准 rename() 和 std::filesystem::rename 都拒绝覆盖。若业务需要“强制重命名”（即覆盖目标），必须手动先删除旧目标：
try {
if (std::filesystem::exists("new.log")) {
std::filesystem::remove("new.log");
}
std::filesystem::rename("temp.log", "new.log");
} catch (const std::filesystem::filesystem_error& e) {
// 处理删除失败或重命名失败
}
但要注意竞态条件：两次调用之间，其他进程可能创建同名文件。真正安全的覆盖需用平台特定 API（如 Windows 的 MoveFileEx 带 MOVEFILE_REPLACE_EXISTING），或改用原子写入模式（写新文件 + 重命名替换）。
常见误操作：
- 直接忽略
std::filesystem::exists()检查，导致remove()报错中断流程 - 用
std::filesystem::remove_all()替代remove()，误删同名目录 - 在 Windows 上对只读文件调用
remove()失败（需先permissions(path, perms::owner_write)）
Windows 下 rename() 与 MoveFileEx 的实际差异
当需要更细粒度控制（比如替换、延迟删除、跨卷移动提示），Windows 原生 MoveFileEx 比 rename() 更合适：
MoveFileExA("old.dll", "new.dll", MOVEFILE_REPLACE_EXISTING | MOVEFILE_WRITE_THROUGH);
关键区别：
-
MOVEFILE_REPLACE_EXISTING原生支持覆盖，无需手动remove -
MOVEFILE_WRITE_THROUGH强制刷新到磁盘，适合关键配置文件更新 - 返回值为布尔型，失败时用
GetLastError()获取详细码（如ERROR_ACCESS_DENIED） - 但它是 Windows 特有 API，不可移植；若项目已用
std::filesystem，优先封装其异常逻辑而非混用
跨平台项目里，别为了一个覆盖标志就引入 Win32 API —— 先检查存在再删除，逻辑清晰且可控。
重命名本身不复杂，真正的坑藏在“目标已存在”“权限异常”“跨文件系统”和“并发访问”这四个交叠场景里。选 std::filesystem::rename 并配好异常处理，比自己拼接系统调用更省心。
