c++oding="utf-8" ?>
parent_path()仅返回上级路径对象，不访问磁盘；要遍历父目录内容需先调用parent_path()获取路径，再用directory_iterator遍历，且必须检查路径存在性与可访问性并捕获filesystem_error异常。
std::filesystem::path 的 parent_path() 返回的是路径对象，不是目录内容列表
很多人误以为 parent_path() 会列出父目录下的所有子项——它不会。它只返回一个表示“上级路径”的 std::filesystem::path 对象，比如 /a/b/c 调用后得到 /a/b，仅此而已。要获取“父级目录对象列表”，实际意思是：拿到指定路径的父目录（即 parent_path()），再遍历该父目录下所有文件/子目录。
正确步骤：先 parent_path()，再 directory_iterator 遍历
必须分两步：先提取父路径，再用该路径构造迭代器。注意路径必须存在且可访问，否则 std::filesystem::directory_iterator 构造时抛出 std::filesystem::filesystem_error。
-
std::filesystem::path p{"/home/user/project/src"}→p.parent_path()得到/home/user/project - 用这个结果创建迭代器：
for (const auto& entry : std::filesystem::directory_iterator(p.parent_path())) { ... } - 每个
entry是std::filesystem::directory_entry，可用entry.path()、entry.is_directory()等判断类型 - 若需排序或缓存全部结果，建议收集到
std::vector<:filesystem::path></:filesystem::path>中再处理，避免多次迭代
常见错误：路径不存在、权限不足、没加异常处理
直接对不存在的路径调用 parent_path() 没问题（它只是字符串操作），但传给 directory_iterator 就会崩溃。典型报错是：filesystem error: cannot iterate directory: No such file or directory 或 Permission denied。
- 务必用
std::filesystem::exists(p.parent_path())和std::filesystem::is_directory(p.parent_path())双重检查 - Linux/macOS 下注意权限位；Windows 下注意符号链接和重解析点可能被跳过
- 推荐包裹在
try/catch中捕获std::filesystem::filesystem_error，而不是依赖断言 - 别忘了链接
-lstdc++fs（GCC）或启用 /std:c++17（MSVC），否则链接失败
性能与边界情况提醒：. 和 .. 会被包含，需手动过滤
directory_iterator 默认包含 .（当前目录）和 ..（父目录）两个特殊条目——这和 shell 的 ls -a 行为一致，但多数场景不需要它们。
- 用
entry.path().filename() == "." || entry.path().filename() == ".."过滤掉 - 注意：Windows 下
filename()对C:\返回空，但对C:\foo\..仍返回".."，逻辑稳定 - 如果目标是“仅获取直接子目录”（排除文件），加一层
if (entry.is_directory() && !entry.is_symlink())判断更安全 - 递归深度控制、大目录性能敏感时，避免在循环内反复调用
entry.status()（可能触发额外系统调用），优先用entry.symlink_status()缓存
parent_path() 不做任何磁盘访问，而 directory_iterator 一构造就访问磁盘并可能失败——这两步不能合并成“一个函数调用”，必须显式拆开、分别容错。**C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
