std::filesystem::create_directories第一次调用失败主因是路径末尾含斜杠导致解析为空目录名；需预处理路径、检查返回值、捕获异常、适配长路径及c++标准版本。
std::filesystem::create_directories 为什么第一次调用就失败？
因为路径末尾有斜杠或反斜杠，std::filesystem::create_directories 会把最后一段当作「文件名」而非目录名处理，导致判断路径不存在却无法创建。比如传入 "build/out/"（结尾带斜杠），它会尝试创建名为 "" 的空目录名，抛出 std::filesystem::filesystem_error。
实操建议：
- 传入前先用
std::filesystem::path::remove_filename()或手动去掉末尾分隔符 - 更稳妥的做法是统一用
std::filesystem::path构造，它自动 normalize 路径分隔符和冗余符号（如"a//b/./c"→"a/b/c"） - Windows 下传入正斜杠
/完全没问题，std::filesystem内部会转义，无需预处理为\
Linux/macOS 下权限不足时 create_directories 返回 false 却不报错？
不是不报错，而是默认行为：只要父目录可写，它会逐级创建；但若某一级目录已存在且权限禁止遍历（比如中间目录只有 r-- 没有 x），create_directories 可能静默返回 false，且不抛异常——这是 C++20 标准允许的实现差异。
实操建议：
- 调用后必须检查返回值：
if (!std::filesystem::create_directories(p)) { /* 失败 */ } - 需要明确错误原因时，捕获
std::filesystem::filesystem_error并 inspect.code().value()（如 Linux 下EACCES是 13） - 避免依赖 umask 自动设权：显式用
std::filesystem::permissions(p, std::filesystem::perms::owner_all)补权限（注意仅对新创建目录生效）
Windows 上遇到“拒绝访问”但路径明明可写？
常见于路径含长文件名（>260 字符）或启用了 Windows 严格路径限制（默认开启）。此时 std::filesystem 底层调用 Win32 API 会直接失败，错误码常为 ERROR_INVALID_NAME (123) 或 ERROR_ACCESS_DENIED (5)，而非预期的权限问题。
实操建议：
- 在
CMakeLists.txt中加add_compile_definitions(WIN32_LEAN_AND_MEAN _CRT_SECURE_NO_WARNINGS)不够，必须启用长路径支持 - 修改注册表
HKEY_LOCAL_MACHINESYSTEMCurrentControlSetControlFileSystemLongPathsEnabled = 1，或通过组策略启用 - 代码中可提前检测：
std::filesystem::path p = "..."; if (p.string().length() > 240) { /* 提示用户缩短路径或检查系统设置 */ }
跨平台构建时 CMake 没开 C++17 支持导致链接失败
std::filesystem 在 GCC 8+ / Clang 7+ / MSVC 2017+ 中默认需显式链接库（如 -lstdc++fs），而 CMake 若未声明标准版本，可能降级到 C++14，导致编译器不认识 std::filesystem 命名空间，或链接时报 undefined reference to 'std::filesystem::create_directories'。
实操建议：
- CMake 中强制指定标准：
set(CMAKE_CXX_STANDARD 17)或更高，并加set(CMAKE_CXX_STANDARD_REQUIRED ON) - 链接阶段补库（GCC/Clang）：
target_link_libraries(your_target stdc++fs)；MSVC 无需额外链接 - 头文件包含必须写全：
#include <filesystem></filesystem>，不能只靠其他头文件间接引入
递归建目录看着简单，但 std::filesystem::create_directories 的行为受路径格式、系统权限模型、C++标准支持程度三重影响，任一环节没对齐，就会卡在看似莫名其妙的错误里。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
