最推荐使用 std::filesystem::rename（c++17起），跨平台、语义清晰、自动路径解析；需确保父目录存在、处理目标已存在时的平台差异，并优先用绝对路径和 try/catch 错误处理。
用 std::filesystem::rename 最直接，C++17 起标准支持
这是目前最推荐的方式，不依赖系统 API，跨平台（Windows/macOS/Linux 都行），语义清晰，且自动处理路径解析。前提是编译器要开 C++17 或更高标准（如 g++ -std=c++17）。
常见错误现象：std::filesystem::rename 抛出 std::filesystem::filesystem_error，比如 “No such file or directory” 或 “Permission denied”。原因通常是源文件不存在、目标路径父目录未创建、或权限不足。
- 目标路径的父目录必须已存在，
rename不会自动创建中间目录 - 如果目标文件已存在，Windows 下默认覆盖失败（报
file exists），Linux/macOS 默认覆盖——行为不一致，需手动处理 - 路径建议用
std::filesystem::path构造，避免手动拼接斜杠出错（尤其 Windows 反斜杠问题）
#include <filesystem>
namespace fs = std::filesystem;
<p>try {
fs::rename("old.txt", "new.txt"); // 同一目录下重命名
} catch (const fs::filesystem_error& e) {
// 检查 e.code().message() 看具体错误
}</p></filesystem>
Windows 下用 MoveFileA / MoveFileW 的兼容性坑
如果你还在维护老旧项目，或需要精确控制（比如带 MOVEFILE_REPLACE_EXISTING 标志），可能得调 Windows API。但要注意：宽字符版 MoveFileW 才真正支持 Unicode 路径；MoveFileA 在中文路径下大概率静默失败。
使用场景：需要替换已存在的目标文件、或在重命名同时移动到另一卷（比如从 C: 到 D:），这时 std::filesystem::rename 会失败（跨卷是复制+删除，不是原子 rename），而 MoveFileW 可以做到。
- 必须用
MoveFileW+L"..."字符串，否则中文路径读不到源文件 - 返回值为
FALSE时，要立刻调GetLastError()，不能只看异常 - 跨卷操作成功后，原文件句柄可能仍有效，但内容已不可靠——别在 rename 后继续读写原
FILE*或std::fstream
Linux/macOS 下 rename() 系统调用的权限和原子性
POSIX 的 rename() 是原子的，且不跨文件系统限制比 C++ 标准库宽松些，但仍有硬约束：不能跨挂载点（mount point）。它也不检查目标是否为目录——如果目标存在且是目录，调用直接失败（errno = EISDIR）。
容易踩的坑在于权限判断逻辑：源文件所在目录需有写+执行权限（wx），目标路径所在目录同样需要；但源文件自身权限无关紧要。
- 头文件是
<unistd.h></unistd.h>，参数是const char*，记得用std::string.c_str() - 目标路径若含多级目录，必须确保最后一级父目录存在，否则报
ENOENT - 不会触发 inotify 监听的
IN_MOVED_FROM/IN_MOVED_TO事件对——如果程序依赖文件监控，得自己补事件
#include <unistd.h>
#include <cerrno><p>if (rename("old.bin", "new.bin") == -1) {
if (errno == ENOENT) { /<em> 源或目标父目录不存在 </em>/ }
else if (errno == EBUSY) { /<em> 文件正被其他进程 mmap 或打开写入 </em>/ }
}</p></cerrno></unistd.h>
重命名失败时，为什么 std::filesystem::exists() 有时也返回 false？
这不是 bug，而是路径解析时机问题。当你传入相对路径（比如 "data/file.txt"），std::filesystem::rename 内部会按当前工作目录解析，但如果工作目录在调用中途被其他线程/信号改变（比如 chdir()），结果就不可预测。更隐蔽的是符号链接：如果路径含 .. 或软链，exists() 和 rename() 对“是否存在”的判定可能不一致。
- 始终用绝对路径调用
rename，可用fs::absolute(path)转换 - 不要依赖
exists()做前置判断——它和rename之间存在竞态窗口，正确做法是直接 try/catch 并根据错误码分支处理 - 如果涉及符号链接，明确用
fs::is_regular_file(p)而非fs::exists(p)，后者对 dangling link 也返回 true
路径解析、跨卷行为、错误码含义这三块，实际写的时候最容易漏掉验证。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
