std::rename可直接重命名文件,但不跨文件系统、不自动处理目标存在、失败不抛异常;需传C字符串、检查返回值与errno,Linux/macOS覆盖同名文件,Windows则失败。

直接用 std::rename 就行,但要注意它不跨文件系统、不自动处理目标已存在、且失败时不抛异常——这是绝大多数 C++ 文件重命名出问题的根源。
std::rename 的基本用法和限制
std::rename 是 C++17 标准库中定义在 里的函数,底层调用系统 rename() 系统调用。它只接受 C 风格字符串(const char*),不支持 std::string 或路径对象直接传入。
Linux 安全审计工具,检查 SSH 配置、开放/监听端口、防火墙规则(ufw/iptables/nftables)、失败登录尝试、sudoers 权限...
- 成功时返回 0;失败返回 -1,并设置
errno - 不能跨分区/挂载点(例如从
/home重命名到/mnt/usb会失败) - 目标路径已存在时,Linux/macOS 会覆盖(等价于
mv -f),Windows 下则失败(errno == EACCES或EEXIST) - 源路径不存在、权限不足、路径中有非法字符,都会导致失败
std::rename
- 用
std::filesystem::exists()判断目标是否已存在(C++17 起可用) - 用
std::filesystem::status()区分是文件还是目录,避免误删 - 注意:
std::filesystem在某些旧编译器(如 GCC 8 以下)需链接-lstdc++fs
std::rename
- 用
std::filesystem::copy_file()复制,再用std::filesystem::remove()删除原文件 - 复制失败时记得清理临时副本,否则会残留垃圾文件
- 大文件复制耗时,且非原子操作——程序中断可能导致源删了、目标没写完
std::rename
- 仅 Windows 需要;Linux/macOS 无此限制
- 前缀必须是字面量
R"(\\?\)",且路径必须为绝对路径 -
std::filesystem在启用长路径策略后会自动处理,但std::rename不会
// Windows 下处理超长路径示例
#ifdef _WIN32
std::string long_path = R"(\\?\C:erylongpath oile.txt)";
std::string new_long = R"(\\?\C:erylongpath o
enamed.txt)";
if (std::rename(long_path.c_str(), new_long.c_str()) != 0) {
// 处理错误
}
#endif
真正麻烦的不是怎么写那行 std::rename,而是你得想清楚:这个操作是否允许覆盖?是否可能跨盘?目标路径是否可控?有没有并发写入?这些判断比函数调用本身重要得多。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!










