std::filesystem::directory_iterator易崩溃主因是路径不存在、权限不足或未启用c++17；须前置检查exists()和is_directory()，用try/catch容错，递归需改用recursive_directory_iterator，访问元数据应一次status()缓存复用。
std::filesystem::directory_iterator 怎么用才不崩溃
直接上手就报 std::filesystem::filesystem_error？大概率是路径不存在、权限不足，或者没开 C++17 支持。这个迭代器不是“自动容错”的，它遇到非法目录项（比如符号链接指向失效路径、权限被拒的子目录）会直接抛异常，而不是跳过。
实操建议：
- 编译时必须加
-std=c++17（GCC/Clang）或设置项目语言标准为 C++17（MSVC） - 务必用
std::filesystem::exists(path)和std::filesystem::is_directory(path)做前置检查 - 别裸写
for (auto& p : std::filesystem::directory_iterator("xxx"))——万一 "xxx" 是文件或根本不存在，程序就挂了 - 想忽略错误继续遍历？得手动 try/catch，
directory_iterator本身不提供“静默跳过”模式
递归遍历所有子目录要用 recursive_directory_iterator
std::filesystem::directory_iterator 只扫一层，这是最容易误解的点。很多人以为它像 Python 的 os.walk，结果写完发现子目录里的文件全没出来。
实操建议：
- 要递归，请换用
std::filesystem::recursive_directory_iterator - 它默认会进入子目录，但遇到权限问题或循环符号链接仍会抛异常
- 可用
pop()手动退出当前层级，或用disable_recursion_pending()跳过某个子目录（比如你想排除build/） - 注意性能：深度嵌套 + 大量小文件时，
recursive_directory_iterator比两层嵌套的directory_iterator略快，但差别不大；真正慢的是频繁的status()调用
获取文件名、路径、大小这些信息怎么写最安全
别直接调 p.filename() 或 p.path() 后再拼字符串——p 是 std::filesystem::directory_entry，它内部缓存了 status() 结果，但不是每次访问都重新 stat。反复调 p.file_size() 或 p.is_regular_file() 会重复系统调用，影响性能；而直接用 p.path().filename() 又可能和实际磁盘状态不一致。
实操建议：
- 一次调用
p.status()获取完整元数据，存到局部变量里再取字段，避免重复 syscall - 文件名用
p.path().filename().string()，不要用p.path().string()再自己 split，Windows 路径分隔符处理容易出错 - 判断是否为普通文件，优先用
p.is_regular_file()，而不是p.path().extension() != ""——没有扩展名的文件（如Makefile）也是合法文件 - 路径拼接一律用
/运算符：root / p.path().filename()，别用字符串拼接
Windows 下中文路径乱码或打不开的根源
不是 directory_iterator 的锅，是 C++ 标准库在 Windows 上默认用窄字符（char）接口调 Win32 API，而 NTFS 存的是 UTF-16。如果源码文件保存为 UTF-8 且没加 BOM，编译器可能把字符串字面量当 GBK 解释，传给 API 就变成乱码路径。
实操建议：
- 源码保存为 UTF-8 with BOM（VS 默认），或显式用
u8"中文路径"字符串前缀 - 确保终端/IDE 控制台代码页是 UTF-8（Windows 10+ 可用
chcp 65001），否则std::cout 显示仍是问号 - 更稳妥的方式：统一用
std::wstring和std::filesystem::wpath，但要注意std::wcout需要先调std::locale::global(std::locale("")) - 跨平台项目？放弃宽字符，坚持 UTF-8 字符串 + 确保构建环境统一，比到处加条件编译更省心
最麻烦的永远不是语法怎么写，而是路径来源不可控——用户输入、配置文件读取、argv 传入，这些地方的编码和合法性校验，比迭代器本身难搞得多。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
