C++如何进行目录创建与删除?(recursive_directory_iterator)

7次阅读

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

C++如何进行目录创建与删除?(recursive_directory_iterator)

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 在各平台都能正确解析

递归删除的本质不是遍历逻辑多复杂,而是路径合法性、权限边界和平台差异这三块最容易漏查。写完记得在目标系统上真机测一次长路径和只读文件场景。

text=ZqhQzanResources