std::filesystem需C++17+标准及GCC 8+、Clang 7+、MSVC 2017 Update 5+支持；编译须加-std=c++17或/std:c++17，GCC/Clang还需链接-lstdc++fs或-lc++fs，否则报undefined reference。
std::filesystem 在哪些编译器和标准下能用
必须用 C++17 或更高标准，且编译器要支持：GCC 8+、Clang 7+、MSVC 2017 Update 5+。如果编译报错 std::filesystem 未定义，先确认是否加了 -std=c++17（GCC/Clang）或 /std:c++17（MSVC），MSVC 还需链接 libstdc++fs 或 stdc++fs —— GCC 要显式加 -lstdc++fs，Clang 同样需要 -lc++fs（部分版本）。
常见错误现象：undefined reference to 'std::filesystem::status'，本质是链接缺失，不是头文件没包含。
怎么安全地检查路径是否存在并区分文件/目录
std::filesystem::exists() 只回答“有没有”，但不告诉你是什么；真正区分类型得靠 std::filesystem::is_regular_file()、std::filesystem::is_directory() 或 std::filesystem::status() 返回的 file_status。
- 不要只用
exists()就调用remove_all()—— 若路径是挂载点或符号链接指向不可访问位置，可能抛出std::filesystem::filesystem_error - 推荐先
status()，再用type()判断：st.type() == std::filesystem::file_type::directory - 注意
symlink_status()和status()的区别：前者不解析符号链接，后者会尝试解析并可能失败
遍历目录时怎么避免递归爆炸和权限拒绝崩溃
std::filesystem::recursive_directory_iterator 默认遇到权限不足或损坏符号链接会直接抛异常，导致整个遍历中断。必须用异常捕获 + increment() 手动推进。
正确做法是：
源分发确定性执行服务，采用固定依赖。仅在带有签名审批制品（ClawShield模式）时运行，并产生可验证的输出...
- 构造迭代器后，用
try { ++it; } catch (const fs::filesystem_error&) { continue; }跳过坏项 - 用
std::filesystem::directory_options::skip_permission_denied选项初始化迭代器，可自动跳过无权访问的子目录（GCC 9.1+、Clang 10+ 支持） - 避免在循环中反复调用
it->path().filename()—— 频繁构造path对象有开销，可缓存auto p = it->path()
移动、重命名文件为什么有时失败，如何处理跨文件系统
std::filesystem::rename() 在同文件系统内是原子的硬链接操作；跨文件系统则退化为“复制 + 删除”，此时失败风险高，且不保证原子性。
关键点：
- 跨设备移动应改用
std::filesystem::copy_file()+std::filesystem::remove()，并手动清理中间状态 -
rename()抛filesystem_error且.code().value()是EXDEV（Linux/macOS）或ERROR_NOT_SAME_DEVICE（Windows），就是跨设备信号 - 目标路径存在时行为取决于
std::filesystem::copy_options—— 比如skip_existing或overwrite_if_exists必须显式传入，否则默认抛异常
跨文件系统的可靠性永远比不上同设备 rename()，这点没法绕过，只能在业务逻辑里接受“非原子”事实。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
