可通过编译测试代码#include 和static_assert验证；需注意编译器版本、标准启用及链接选项，如GCC
怎么判断 std::filesystem 在你的编译器上能用
不是所有 C++17 编译环境都默认启用 std::filesystem，尤其 Windows 上 MSVC 和 MinGW 行为差异大，Linux 上 GCC 早于 9.1 的版本需要额外链接 -lstdc++fs。
- Clang/LLVM：需确认是否启用了
-std=c++17且 libc++ 或 libstdc++ 版本够新（libc++ 7+ / libstdc++ 9.1+） - MSVC：Visual Studio 2017 15.7+ 支持，但必须加
/std:c++17，且项目属性里「C/C++ → 语言 → 启用 C++ 扩展」不能设为「否」 - MinGW-w64：多数发行版（如 MSYS2 的 mingw64）已支持，但旧版（如 TDM-GCC）可能完全缺失实现，编译时会报错
error: 'filesystem' is not a namespace-name
最稳的验证方式是写一行测试代码：
#include <filesystem> static_assert(std::is_same_v<std::filesystem::path, std::filesystem::path>);
std::filesystem::path 的构造和拼接为什么总出错
常见错误是直接用字符串字面量拼接路径，比如 "a/" + "b"，结果不是 path，而是 const char* 加法——编译失败或行为未定义。正确做法是让 path 对象主导拼接。
- 构造时优先用
std::filesystem::path字面量（C++20 起支持"a/b"_path），C++17 则用std::filesystem::path("a") / "b" -
/是重载运算符，用于拼接；+=和+=也有效，但语义不同：p /= "b"等价于p = p / "b"，而p += "b"是字符串追加（不加分隔符） - Windows 下传入
"C:\foo"没问题，但用R"(C: oo)"更安全；Linux/macOS 不接受反斜杠作为路径分隔符，path构造时会自动 Normalize，但别依赖它来“修复”错误输入
示例：
立即学习“C++免费学习笔记（深入）”；
auto p = std::filesystem::path{"src"} / "main.cpp"; // ✅ 正确
auto q = std::filesystem::path{"src"} += "main.cpp"; // ❌ 得到 "srcmain.cpp"遍历目录时 std::filesystem::directory_iterator 报 filesystem_error
典型错误是没捕获异常，或者忽略权限不足、符号链接循环、设备忙等系统级错误。迭代器本身不检查路径可访问性，第一次解引用才真正触发 I/O —— 所以 for (auto& p : dir_iter) 可能在中间某次抛异常。
- 必须用
try/catch包裹整个循环体，或对每个*it单独 try - 想跳过不可访问项（如无权限子目录），用
std::filesystem::directory_options::skip_permission_denied构造迭代器 - 递归遍历慎用
recursive_directory_iterator：默认会跟随符号链接，可能导致无限循环；加std::filesystem::directory_options::follow_directory_symlink显式控制 - 性能注意：每次
*it都可能触发stat()系统调用，频繁访问.status()或.file_size()会显著变慢
推荐写法：
for (auto it = std::filesystem::directory_iterator{"."}; it != std::filesystem::directory_iterator{}; ++it) {
try {
if (it->is_regular_file()) { /* ... */ }
} catch (const std::filesystem::filesystem_error& e) {
// 忽略或记录 e.what()
}
}跨平台路径比较和存在性判断的坑
std::filesystem::exists(p) 返回 false 不一定代表路径不存在——可能是权限不足、挂载点失效、甚至 NFS 超时。更麻烦的是大小写敏感性：Linux/macOS 默认区分大小写，Windows 默认不区分，但 NTFS 实际支持区分大小写（取决于系统设置）。
- 不要用
exists()当唯一判断依据，尤其在用户输入路径后；先status_known(p)看元数据是否已缓存，再结合is_regular_file()等细化判断 - 路径相等比较用
p1 == p2是值语义（标准化后比较），但要注意"./a"和"a"相等，而"a"和"A"在 Windows 上可能相等，在 Linux 上不等 - 若需严格按字节比较（比如校验配置路径），用
p1.native() == p2.native()，但失去跨平台抽象意义 - 相对路径处理要小心：
exists("config.txt")查的是当前工作目录，不是可执行文件所在目录；需要用std::filesystem::current_path()或std::filesystem::canonical()归一化
真正稳定的做法是：对关键路径先 canonical()，再 exists() + is_regular_file() 组合判断。
