std::filesystem::rename是c++17最标准跨平台文件移动方式,同文件系统内原子重命名,跨分区退化为复制+删除;需捕获filesystem_error异常并处理exdev等错误。

std::filesystem::rename 在 C++17 中怎么用
直接调用 std::filesystem::rename 是最标准、跨平台的方式,但前提是编译器支持 C++17 且启用了文件系统库。它不复制内容,只改路径名,速度快、原子性强。
常见错误是忽略异常或没链接标准库:
- 没加
-lstdc++fs(GCC)或/std:c++17+ 链接stdc++fs(Clang),会报 undefined reference 到std::filesystem::rename - 目标路径已存在时,默认抛出
std::filesystem::filesystem_error,不是静默覆盖 - 源路径不存在或权限不足时,同样抛异常,不会返回 false
示例:
#include <filesystem>
namespace fs = std::filesystem;
try {
fs::rename("old.txt", "new.txt");
} catch (const fs::filesystem_error& e) {
// 比如 "No such file or directory" 或 "File exists"
std::cerr
<h3>Windows 下用 _wrename 处理中文路径</h3>
<p><code>_wrename</code> 支持宽字符,对含中文、日文等 Unicode 路径更稳妥,尤其在旧项目或未启用 C++17 时。但它仅限 Windows,不可移植。</p>
<p>关键点:</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/shouce/1510" title="C函数速查手册(CHM版)"><img
src="https://img.php.cn/upload/manual/000/000/001/5d6de31fedca2993.png" alt="C函数速查手册(CHM版)" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/shouce/1510" title="C函数速查手册(CHM版)" class="overflowclass">C函数速查手册(CHM版)</a>
<p class="overflowclass">C函数速查手册(CHM版)</p>
</div>
<a rel="nofollow" href="/xiazai/shouce/1510" title="C函数速查手册(CHM版)" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<ul>
<li>必须用 <code>std::wstring</code>,不能传 <code>std::string</code> 给 <code>_wrename</code>
</li>
<li>路径字符串需为 UTF-16(通常由 <code>MultiByteToWideChar</code> 或 C++20 的 <code>std::from_chars</code> 转换而来)</li>
<li>如果路径含前导空格或点号(如 <code>" .txt"</code>),Windows 可能拒绝操作,<code>_wrename</code> 返回 -1</li>
</ul>
<p>简单用法:</p>
<pre class="brush:php;toolbar:false;">#include <stdio.h>
#include <wchar.h>
std::wstring from_utf8(const std::string& s) {
// 实际项目建议用 Windows API 或 ICU 转换
// 此处仅为示意,不处理代理对
return std::wstring(s.begin(), s.end());
}
_wrename(from_utf8("旧文件.txt").c_str(),
from_utf8("新文件.txt").c_str());</wchar.h></stdio.h>
rename() 系统调用的可移植陷阱
C 标准库的 rename() 在 Linux/macOS 和 Windows(MSVC)都可用,但行为有差异:
- Linux/macOS:若目标存在且是空目录,
rename()会把源重命名为该目录下的同名项(即“移动进目录”),不是覆盖 - Windows:目标存在时直接失败(
errno = EACCES),除非目标是文件且可写 - 跨设备(不同挂载点)时,所有平台均失败,
errno = EXDEV—— 此时得手动 copy + unlink
检查失败原因比盲目重试更重要:
#include <cstdio>
#include <cerrno>
if (rename("a.log", "b.log") != 0) {
if (errno == EXDEV) {
// 需要先 copy 再 unlink("a.log")
} else if (errno == EACCES || errno == ENOENT) {
// 权限问题或源不存在
}
}</cerrno></cstdio>
为什么不能直接改 open() 后的文件句柄名
操作系统层面,文件名只是目录项(directory entry)的引用,打开后的 FILE* 或 fd 指向的是 inode 或 HANDLE,与路径名解耦。所以:
- 没有类似
frename()的 POSIX 函数 - Windows 的
SetFileInformationByHandle只能改创建时间、属性等,不能改名字 - 试图在 rename 同时写入文件?没问题;但若 rename 前文件被其他进程 delete,rename 仍成功(原内容还在,直到所有 fd 关闭)
真正要“改名并保证数据安全”,得确保 rename 前 flush 所有缓冲(fflush(fp)),且 rename 是最后一步 —— 这点容易被忽略,尤其在日志轮转场景里。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!










