std::filesystem::create_directory仅创建单层目录且要求父目录存在,递归创建应使用create_directories;remove仅删文件或空目录,删除整个目录树须用remove_all。

用 std::filesystem::create_directory 创建单层目录,别误用 create_directories
创建目录最常踩的坑是:想建 /a/b/c 却只调 create_directory,结果失败返回 false —— 它只建最后一级,且要求父目录必须已存在。真正“递归建目录”得用 create_directories。
实操建议:
立即学习“C++免费学习笔记(深入)”;
-
create_directory适合明确知道父路径已存在时,比如在临时目录下建一个子目录 -
create_directories才等价于 shell 的mkdir -p,会逐级创建缺失的上级目录 - 两者都返回
bool,务必检查返回值;失败常见原因是权限不足或路径含非法字符(如 Windows 下:|) - C++17 起支持,编译需加
-std=c++17,链接时部分平台(如旧版 GCC)可能需显式链接-lstdc++fs
删除空目录用 remove,删非空目录必须用 remove_all
std::filesystem::remove 只删文件或空目录;对非空目录直接返回 false,不报错也不递归。很多人卡在这儿,以为函数出 bug,其实是用错了接口。
实操建议:
立即学习“C++免费学习笔记(深入)”;
- 删单个空目录:
remove("path/to/empty_dir") - 删整个目录树(含子目录、文件):
remove_all("path/to/dir")—— 这才是对应rm -rf的行为 - 两个函数都返回
uintmax_t(删了多少项),0表示没删任何东西(路径不存在或权限拒绝) - 注意
remove_all是不可逆操作,没有回收站;调试时建议先用is_empty或遍历确认内容
recursive_directory_iterator 不是用来删目录的,别把它和删除逻辑混在一起
看到名字带 “recursive”,容易误以为它能自动删子目录。其实它只是读取工具,类似 Python 的 os.walk,本身不修改文件系统。强行用它边遍历边删,大概率触发未定义行为(迭代器失效、路径访问冲突)。
实操建议:
立即学习“C++免费学习笔记(深入)”;
- 需要遍历+处理内容?用
recursive_directory_iterator收集路径,再统一操作 - 要安全删整个目录树?直接调
remove_all,比手写递归删快、稳、少出错 - 真要手动控制删除顺序(比如先删文件再删目录),可用
directory_iterator配合is_regular_file/is_directory判断,但没必要 ——remove_all内部已优化好顺序
Windows 下路径分隔符和长路径限制是隐形雷区
在 Windows 上,std::filesystem 默认接受正斜杠 / 和反斜杠 ,但遇到 UNC 路径(如 \servershare)或超过 260 字符的路径时,行为会突变 —— 尤其是 remove_all 可能静默失败。
实操建议:
立即学习“C++免费学习笔记(深入)”;
- 路径字符串尽量用原始字面量:
R"(C: empmydir)"避免转义混乱 - 长路径前加
\\?\前缀(如R"(\\?C:erylongpath)"),否则可能被 Windows API 截断 - 删除前用
exists+status确认路径可访问,避免因符号链接断裂或权限问题导致remove_all返回0 - 跨平台代码中,统一用
/分隔符,std::filesystem在各平台都能正确解析
递归删除的本质不是遍历逻辑多复杂,而是路径合法性、权限边界和平台差异这三块最容易漏查。写完记得在目标系统上真机测一次长路径和只读文件场景。










