正确初始化需传存在且可读路径，Windows用"/"或"\"；遍历用范围for避免迭代器失效；跨平台注意大小写、隐藏文件和符号链接处理；链接-lstdc++fs并统一UTF-8路径编码。
std::filesystem::directory_iterator 怎么正确初始化
直接传路径字符串进去就行，但必须确保路径存在且有读取权限，否则会抛 std::filesystem::filesystem_error。Windows 下路径分隔符用正斜杠 / 或双反斜杠 \ 都可以，但单个反斜杠 是非法转义字符，会编译失败。
- 推荐写法：
std::filesystem::directory_iterator{"/path/to/dir"}或std::filesystem::directory_iterator{"C:/data"} - 错误写法：
std::filesystem::directory_iterator{"C:data"}（d被解释为转义） - 调试时先用
std::filesystem::exists(path)和std::filesystem::is_directory(path)检查，避免一上来就崩溃
遍历中怎么跳过子目录或只处理特定后缀文件
directory_iterator 默认只遍历当前层，不递归；每个迭代项是 std::filesystem::directory_entry，它能告诉你这是文件还是目录，并提供 path()、extension() 等方法。
- 跳过子目录：
if (entry.is_regular_file()) { ... } - 只处理 .cpp 文件：
if (entry.path().extension() == ".cpp")（注意.extension()返回的是std::filesystem::path，不是std::string，直接比较字符串字面量可行，但更稳妥是用.extension().string() == ".cpp"） - 注意：
.extension()对main.cpp.bak返回.bak，不是.cpp；要取主扩展名得用.stem().extension()组合判断，实际中建议用path().filename().string()做完整匹配
为什么循环里 auto it = begin(dir); ++it; 会崩溃
std::filesystem::directory_iterator 是输入迭代器，不支持多次遍历，也不保证拷贝后仍有效。常见误操作是把迭代器存起来、反复用，或者在循环中手动递增却没检查是否到 end。
- 正确写法就是范围 for：
for (const auto& entry : std::filesystem::directory_iterator{path}) { ... } - 如果必须手动控制，一定要配对使用：
auto it = std::filesystem::directory_iterator{path}; auto end = std::filesystem::directory_iterator{};，然后while (it != end) { ... ++it; } - 别对同一个
directory_iterator实例调用两次++之后还用它——它的内部状态可能已失效，尤其在某些 libc++ 实现下会触发断言
跨平台要注意的三个细节
Linux/macOS 默认区分大小写，Windows 不区分；directory_iterator 的行为本身是标准规定的，但底层表现受 OS 影响，尤其在路径合法性、隐藏文件可见性、符号链接处理上。
立即学习“C++免费学习笔记（深入）”；
- 隐藏文件（如 Linux 的
.git）默认会被遍历出来，不自动过滤；需要自己判断entry.path().filename().string()[0] == '.' - 遇到符号链接时，
entry.is_symlink()为 true，但entry.is_regular_file()可能也为 true（如果指向文件），需按需决定是否follow_symlink - C++17 标准要求编译器开启
std::filesystem支持，GCC 需加-lstdc++fs，Clang 同样要链接，MSVC 一般默认支持；没链接会导致运行时报undefined symbol错误，而不是编译错
最麻烦的其实是路径编码：Windows 上宽字符路径（std::wstring）和 UTF-8 字节流混用时容易出乱码，除非明确用 u8"path" 字面量或确保 locale 设置一致，否则中文路径大概率打不开。
