std::filesystem::is_directory()返回false的常见原因包括路径不存在、权限不足、符号链接未解析目标、Windows非法字符等；应先用exists()或status()预检，再结合is_symlink()和read_symlink()安全判断。
std::filesystem::is_directory() 返回 false 的常见原因
直接调用 std::filesystem::is_directory(path) 却返回 false，大概率不是函数写错了，而是路径本身不可访问或状态未缓存。该函数不抛异常（除非路径语法非法），但对不存在的路径、权限不足的路径、符号链接默认都返回 false —— 它只对「存在且确实是目录」的路径返回 true。
- 路径不存在时返回
false，不会报错也不会提示 - 若
path是符号链接，默认不解析目标，只判断链接自身类型（链接文件不是目录） - Windows 下若路径含非法字符（如
"CON"、"PRN"）或权限被拒，也会静默失败 - 建议先用
std::filesystem::exists(path)或std::filesystem::status(path)预检
正确判断目录的三步写法（含异常处理）
安全做法是组合使用 status() + 类型检查，避免重复访问文件系统，也覆盖符号链接场景：
try {
auto s = std::filesystem::status(path);
if (std::filesystem::is_directory(s)) {
// 是目录
} else if (std::filesystem::is_symlink(s) && std::filesystem::is_directory(std::filesystem::read_symlink(path))) {
// 是指向目录的符号链接
}
} catch (const std::filesystem::filesystem_error& e) {
// 权限拒绝、路径过长、设备不可用等会抛此异常
std::cerr
-
status()一次获取路径元信息，比多次调用is_directory()更高效 - 显式捕获
std::filesystem::filesystem_error，而不是依赖errno或忽略异常 - 若需跟随符号链接，用
std::filesystem::symlink_status()替代status()，再配合is_symlink()判断
Windows 下路径字符串的编码陷阱
在 MSVC 或 MinGW-w64 中，若用窄字符串（std::string）传入含中文或特殊字符的路径，std::filesystem 可能因代码页不匹配误判为不存在，进而让 is_directory() 返回 false。
- Windows 推荐统一用
std::wstring构造std::filesystem::path：std::filesystem::path p(L"中文目录") - 若必须用
std::string，确保源文件保存为 UTF-8 且编译器启用/utf-8（MSVC）或-finput-charset=utf-8（GCC/Clang） - 不要依赖
std::filesystem::u8path()自动转换——它在 Windows 上对非 ASCII 字符行为不稳定
跨平台编译时的链接与标准版本要求
std::filesystem 不是“开箱即用”的头文件功能，它依赖底层库实现，容易在构建阶段出问题：
- MSVC：需 C++17 以上 + 链接
libcmt.lib（静态）或msvcrt.lib（动态），CMake 中加target_link_libraries(myapp PRIVATE stdc++fs)不起作用 - Linux（GCC）：需
-lstdc++fs，且 GCC 9+ 才完全支持；GCC 8 需手动定义_GLIBCXX_FILESYSTEM_IS_LINUX - macOS：Clang 10+ 原生支持，但需确保 SDK 版本 ≥ 10.15（否则
std::filesystem::status()可能返回file_status::none）
最易被忽略的是：即使代码编译通过，运行时若链接缺失或系统库太旧，is_directory() 可能始终返回 false 而不报错——务必在目标环境实测。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
