std::filesystem::create_directories是c++17起跨平台创建多级目录的唯一推荐方案,自动补全中间路径且幂等;需传入目录路径(用parent_path()提取),检查返回值并捕获filesystem_error。

std::filesystem::create_directories 是唯一靠谱的方案
别折腾 mkdir 系统调用或自己递归建目录,C++17 起 std::filesystem::create_directories 就是干这个的——它会自动补全所有不存在的中间路径,且幂等(重复调用不报错)。Windows、Linux、macOS 全平台可用,只要编译器支持 C++17 且开了 -std=c++17(GCC/Clang)或 /std:c++17(MSVC)。
常见错误是直接传入文件路径给 create_directories,比如 create_directories("a/b/c/file.txt"),这会失败:它只接受目录路径,不是文件路径。必须先提取父目录。
- 正确做法:用
std::filesystem::path的parent_path()提取目录部分 - 务必检查返回值:
create_directories返回bool,true表示至少新建了一个目录,false表示路径已存在(也算成功) - 如果父目录创建失败(如权限不足、磁盘满),它会抛出
std::filesystem::filesystem_error,不捕获就 crash
写文件前必须先确保父目录存在,顺序不能反
有人把 ofstream 打开和目录创建混在一起,或者想“边写边建”,这是错的。C++ 文件流不会帮你建目录——ofstream("a/b/c/file.txt") 在 a/b/c 不存在时直接失败,连 is_open() 都返回 false,不会给你任何提示“目录不存在”。
- 必须严格按顺序:先调用
create_directories(path.parent_path())→ 检查是否成功 → 再打开ofstream - 不要依赖
ofstream::fail()来判断是不是目录问题,它只告诉你“打不开”,不区分原因(可能是只读、路径错、没权限、目录缺……) - 如果目标路径含相对路径(如
"../out/data.txt"),parent_path()仍能正确解析,但要注意当前工作目录的影响
Windows 下路径分隔符和长路径要注意
Windows 默认用反斜杠 ,但 std::filesystem 内部统一处理正斜杠 / 和反斜杠,所以写 "a/b/c" 或 "a\b\c" 都行。真正容易踩坑的是 Windows 的 MAX_PATH 限制(260 字符)。
- 若路径超长(尤其深层嵌套+长文件名),即使调用
create_directories也可能失败,报错信息类似The system cannot find the path specified - 解决方法:在路径前加
\\?\前缀(仅 Windows),例如std::filesystem::create_directories(L"\\?\C:\very\long\path") - 注意:前缀只对绝对路径有效,且要用宽字符字符串(
std::wstring)或 UTF-8 编码 + 启用 Unicode 支持(MSVC 默认支持,GCC/Clang 需-finput-charset=utf-8 -fexec-charset=utf-8)
没有 C++17?别硬套,换更稳妥的退路
如果项目卡在 C++11/14,别用 Boost.Filesystem(依赖重、编译慢),也别手写递归 mkdir(Windows/Linux API 差异大、权限处理麻烦)。最轻量的替代是直接调系统命令,但只限开发机或可控环境:
- Linux/macOS:用
system("mkdir -p a/b/c"),简单粗暴,-p就是“自动建多级” - Windows:用
system("mkdir a\b\c")(cmd 自带mkdir支持多级) - 风险点:
system会 fork 进程,有性能开销;路径含空格或特殊字符时要转义;无法细粒度捕获失败原因
真正跨平台又不用 C++17 的生产级方案,其实是封装一层极简的 mkdir_p,调用 stat + mkdir 循环,但代码量比直接升 C++17 多三倍,维护成本高——除非真被卡死,否则优先升级标准。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











