std::rename可直接重命名文件，但不跨文件系统、不自动处理目标存在、失败不抛异常；需传C字符串、检查返回值与errno，Linux/macOS覆盖同名文件，Windows则失败。
直接用 std::rename 就行，但要注意它不跨文件系统、不自动处理目标已存在、且失败时不抛异常——这是绝大多数 C++ 文件重命名出问题的根源。
std::rename 的基本用法和限制
std::rename 是 C++17 标准库中定义在 rename() 系统调用。它只接受 C 风格字符串（const char*），不支持 std::string 或路径对象直接传入。
- 成功时返回 0；失败返回 -1，并设置
errno - 不能跨分区/挂载点（例如从
/home重命名到/mnt/usb会失败） - 目标路径已存在时，Linux/macOS 会覆盖（等价于
mv -f），Windows 下则失败（errno == EACCES或EEXIST） - 源路径不存在、权限不足、路径中有非法字符，都会导致失败
std::string old_name = "old.txt";
std::string new_name = "new.txt";
int result = std::rename(old_name.c_str(), new_name.c_str());
if (result != 0) {
switch (errno) {
case ENOENT: std::cerr << "源文件不存在\n"; break;
case EACCES: std::cerr << "权限不足或目标已存在（Windows）\n"; break;
case EXDEV: std::cerr << "跨文件系统移动不被支持\n"; break;
default: std::cerr << "重命名失败: " << strerror(errno) << "\n";
}
}
跨平台安全重命名：先检查再操作
Windows 下 std::rename 对已存在目标默认失败，而 POSIX 系统会静默覆盖。若你希望行为一致（比如拒绝覆盖），必须手动检查目标是否存在。
- 用
std::filesystem::exists()判断目标是否已存在（C++17 起可用） - 用
std::filesystem::status()区分是文件还是目录，避免误删 - 注意：
std::filesystem在某些旧编译器（如 GCC 8 以下）需链接-lstdc++fs
#includenamespace fs = std::filesystem; if (fs::exists("target.txt")) { std::cerr << "目标文件已存在，跳过重命名\n"; return; } if (std::rename("source.txt", "target.txt") != 0) { std::cerr << "重命名失败: " << strerror(errno) << "\n"; }
需要移动到不同目录？别用 rename，改用 copy + remove
std::rename 本质是“原子重命名”，仅适用于同一文件系统内的同级或子目录移动。一旦涉及跨目录且目标路径层级更深（比如 "a.txt" → "sub/b.txt"），或你想保留原文件，就必须换思路。
立即学习“C++免费学习笔记（深入）”；
- 用
std::filesystem::copy_file()复制，再用std::filesystem::remove()删除原文件 - 复制失败时记得清理临时副本，否则会残留垃圾文件
- 大文件复制耗时，且非原子操作——程序中断可能导致源删了、目标没写完
try {
fs::copy_file("old.txt", "dir/new.txt", fs::copy_options::overwrite_existing);
fs::remove("old.txt");
} catch (const fs::filesystem_error& e) {
std::cerr << "移动失败: " << e.what() << "\n";
// 此时 old.txt 仍存在，可做恢复逻辑
}
Windows 下特殊路径和长路径问题
Windows 默认对路径长度限制为 260 字符（MAX_PATH），若路径超长，std::rename 会直接失败（errno == ENAMETOOLONG）。即使启用了长路径支持，也要加 \\\\?\\ 前缀才能生效。
- 仅 Windows 需要；Linux/macOS 无此限制
- 前缀必须是字面量
R"(\\\\?\\)"，且路径必须为绝对路径 -
std::filesystem在启用长路径策略后会自动处理，但std::rename不会
// Windows 下处理超长路径示例
#ifdef _WIN32
std::string long_path = R"(\\\\?\\C:\very\long\path\to\file.txt)";
std::string new_long = R"(\\\\?\\C:\very\long\path\to\renamed.txt)";
if (std::rename(long_path.c_str(), new_long.c_str()) != 0) {
// 处理错误
}
#endif
真正麻烦的不是怎么写那行 std::rename，而是你得想清楚：这个操作是否允许覆盖？是否可能跨盘？目标路径是否可控？有没有并发写入？这些判断比函数调用本身重要得多。
