std::filesystem::create_directories 更可靠,因它自动创建所有缺失父目录,已处理符号链接、权限、并发等边界情况,跨平台兼容且避免手写递归的路径拆分与层级判断错误。

std::filesystem::create_directories 为什么比手写递归更可靠
它直接处理路径中所有缺失的父目录,不用自己判断层级、拆分路径、逐级调用 create_directory。标准库已考虑符号链接、权限、并发竞争等边界情况,手写递归容易在跨平台时出错(比如 Windows 路径分隔符 '\' vs Unix '/')。
常见错误现象:std::filesystem::create_directory("a/b/c") 报 std::filesystem::filesystem_error: No such file or directory —— 因为父目录 a 和 a/b 不存在,而 create_directory 只建最后一级。
- 必须包含头文件:
#include <filesystem></filesystem>,并链接-lstdc++fs(GCC 早期版本)或启用 C++17 标准(-std=c++17) - 路径参数支持
std::string、const char*或std::filesystem::path;推荐用std::filesystem::path避免手动拼接分隔符 - 返回
bool:成功创建至少一个新目录时为true;若所有目录已存在,也返回true(这点和create_directory不同)
Windows 下路径字符串要小心转义和原始字面量
写 "C: empmyapplogs" 会触发转义: 变成制表符,m 非法,编译失败。不加处理就传给 create_directories,实际路径就错了。
使用场景:硬编码路径、配置读取后未标准化、日志目录初始化。
- 用原始字符串字面量最省心:
R"(C: empmyapplogs)"或R"(/var/log/myapp)" - 或者统一用正斜杠:
"C:/temp/myapp/logs"——std::filesystem在 Windows 上完全支持 - 避免混合写法:
"C:\temp\myapp\logs"可行但易漏写反斜杠,可读性差
权限控制不是默认行为,得靠 umask 或后续 chmod
create_directories 创建的目录权限取决于当前进程的 umask(Unix-like 系统),Windows 则基本忽略权限参数。这意味着你可能得到 755、700 甚至 777,而不是你预期的 750。
性能影响:额外调用 permissions() 几乎无开销;但若在循环里反复设置,要注意系统调用次数。
- Unix/Linux/macOS:先调用
create_directories,再用std::filesystem::permissions(path, std::filesystem::perms::owner_read | std::filesystem::perms::owner_write | std::filesystem::perms::owner_exec | std::filesystem::perms::group_read | std::filesystem::perms::group_exec) - Windows 上该调用被忽略,无需执行
- 不要依赖构造函数或参数传入权限 ——
create_directories没有权限参数
路径存在但不可访问时,错误信息容易误导
比如目录 /home/user/protected 存在,但当前用户无执行权限(x),create_directories 仍会报 No such file or directory,而非 Permission denied。这是因为缺少 x 权限导致无法进入该目录,底层 stat() 失败,被误判为“不存在”。
使用场景:容器内运行、CI 环境挂载目录权限受限、sudo 切换用户后家目录不可达。
- 调试时先用
std::filesystem::exists(path.parent_path())和std::filesystem::is_directory(path.parent_path())分步检查 - 再用
access(path.parent_path().c_str(), X_OK)(POSIX)或GetFileAttributes(Windows)确认可访问性 - 别只看异常消息字面意思,要结合
std::filesystem::status_code和 errno 综合判断
真正麻烦的是权限 + 符号链接 + 相对路径混用的情况 —— 这时候 create_directories 的行为依赖于 std::filesystem::canonical 是否生效,而它又可能因权限不足直接失败。这种组合问题,光靠一个函数调用压不住。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











