直接用 std::filesystem 是可行的，但必须确认编译器支持 C++17 且启用了对应标准，否则会编译失败或行为异常。
编译前必须检查的三件事
很多“找不到 namespace filesystem” 或 “undefined reference to std::filesystem::…” 的错误，其实都卡在这几步：
- 编译器版本：GCC ≥ 8.1、Clang ≥ 7、MSVC ≥ 19.20（VS 2019）才完整支持；旧版本即使加了
-std=c++17也可能链接失败 - C++ 标准开关：GCC/Clang 必须显式加
-std=c++17（-std=gnu++17也行），不能只靠#include - 链接 stdc++fs 库：GCC 需要额外加
-lstdc++fs；Clang 在某些系统（如 macOS）也要加-lc++fs；MSVC 自动链接，不用管
创建/删除目录最简写法（含错误处理）
别直接调用 create_directories() 就完事，它返回 bool，但不告诉你具体哪步失败。实际开发中建议用带 std::error_code& 重载：
namespace fs = std::filesystem;
fs::path p = "/tmp/myapp/cache";
std::error_code ec;
if (!fs::create_directories(p, ec)) {
if (ec) {
// 打印真实错误，比如权限不足、父路径不存在等
std::cerr << "Failed to create " << p << ": " << ec.message() << "/n";
}
}
注意：create_directories() 创建多级目录（类似 shell 的 mkdir -p），而 create_directory() 只建最后一级，父目录不存在就失败。
立即学习“C++免费学习笔记（深入）”；
遍历目录时容易忽略的符号链接与异常
fs::directory_iterator 默认不跟随符号链接，且遇到权限不足或损坏的 symlink 会抛 std::filesystem::filesystem_error —— 这在容器或 CI 环境里很常见。
- 加
fs::directory_options::skip_permission_denied跳过无权读取的条目 - 用
fs::recursive_directory_iterator时，传fs::directory_options::follow_directory_symlink才会进入 symlink 指向的目录 - 强烈建议用
std::error_code版本构造迭代器，避免程序崩溃：fs::directory_iterator(p, ec)
跨平台路径拼接必须用 / 运算符，别用字符串拼接
Windows 用反斜杠 /，Linux/macOS 用正斜杠 /，但 std::filesystem::path 内部统一处理。手动拼字符串会出问题：
fs::path p = "/home/user"; p /= "data"; // ✅ 正确：自动适配分隔符 p /= "config.json"; // ❌ 错误示例（尤其在 Windows 上）： std::string bad = p.string() + "//" + "log.txt"; // 可能变成 /home/user/log.txt
所有路径操作——拼接、扩展名提取（p.extension()）、父路径（p.parent_path()）、相对化（fs::relative(a, b)）——都应通过 path 成员函数完成。硬编码 "//" 或 "/" 是跨平台大忌。
最麻烦的是 Windows 上的长路径和保留名（如 CON、AUX），std::filesystem 不做校验，得自己用 fs::status() 或正则预判。