std::filesystem::replace_extension 仅修改路径对象的逻辑表示，不更改磁盘文件；真正改后缀需配合 fs::rename，且须检查目标是否存在、文件是否为常规文件，并注意跨卷、文件占用等系统限制。
std::filesystem::replace_extension 为什么改不了后缀？
它只修改路径对象的逻辑表示，不碰磁盘上的文件——这是最常被误解的一点。调用 replace_extension 后得到的是一个新路径字符串，原文件名没变，更不会重命名文件。
- 常见错误现象：
fs::path p = "a.txt"; p.replace_extension(".log");执行完p变成"a.log"，但磁盘上仍是a.txt - 正确做法：必须配合
fs::rename才能真正改后缀 - 注意
replace_extension会先移除原有扩展名（包括点），再拼接新扩展名；传入空字符串或""会删掉扩展名，传入"log"和".log"效果一样
批量重命名文件后缀的最小可靠写法
核心就三步：遍历、构造新路径、调用 rename。别绕弯，也别用 system("ren ...") 这类平台依赖操作。
- 使用场景：当前目录下所有
.txt改成.log，跳过子目录 - 必须检查目标路径是否已存在，否则
rename抛fs::filesystem_error - 建议用
fs::is_regular_file过滤，避免把目录或符号链接当文件处理 - 示例片段：
for (const auto& entry : fs::directory_iterator(".")) {
if (fs::is_regular_file(entry) && entry.path().extension() == ".txt") {
fs::path new_path = entry.path();
new_path.replace_extension(".log");
if (!fs::exists(new_path)) {
fs::rename(entry.path(), new_path);
}
}
}
Windows 下 rename 失败的几个硬坑
不是代码写错了，而是系统级限制在卡你。
- 目标文件已打开（比如被记事本、IDE 或日志进程占用）→
rename直接失败，报错信息通常是Permission denied或Access is denied - 源和目标在不同驱动器（如从
C:\改到D:\）→fs::rename不支持跨卷移动，必须用复制+删除组合 - 路径含中文或特殊字符时，确保编译器和终端都用了 UTF-8 编码（MSVC 需加
/utf-8，GCC/Clang 默认较稳） - 不要依赖
fs::current_path()的返回值做拼接——它可能含末尾斜杠，也可能不含，用fs::path构造更安全
要不要递归处理子目录？小心路径爆炸
递归本身很简单，但真实项目里往往需要控制范围，否则一不小心就把 build/ 或 .git/ 里的文件也扫进去了。
- 用
fs::recursive_directory_iterator替换directory_iterator即可开启递归 - 但强烈建议加过滤：跳过隐藏目录（名字以
.开头）、跳过构建目录（如build、out、target） -
replace_extension对没有扩展名的文件（如Makefile）会静默忽略，不会报错也不会生成.log，这点要心里有数 - 性能影响不大，但 IO 密集型操作，别在循环里反复调用
fs::status查属性——directory_entry已缓存了基本元数据
replace_extension，而在判断“能不能动”和“动了之后会不会引发连锁问题”。比如配置文件被其他进程锁着、CI 流水线里路径大小写敏感、或者某个脚本硬编码了旧后缀——这些都不是 C++ 标准库能管的。C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
