c++oding="utf-8" ?>
std::filesystem::is_empty仅当目录存在、可访问且确为目录时返回true/false,否则抛出filesystem_error异常,须用try-catch防护或先调用exists()和is_directory()预检。

用 std::filesystem::is_empty 判断目录是否为空,前提是目录存在且可访问
这个函数不会帮你检查路径是否存在或是否有权限——它只在目录确实存在且能枚举内容的前提下返回 true 或 false。如果传入一个不存在的路径、权限不足的路径,或者路径指向的是普通文件而非目录,std::filesystem::is_empty 会抛出 std::filesystem::filesystem_error 异常。
常见错误现象:terminate called after throwing an instance of 'std::filesystem::filesystem_error',但没捕获异常,程序直接崩溃。
- 务必用
try-catch包裹调用,或先用std::filesystem::exists()和std::filesystem::is_directory()预检 - 注意:即使
exists()返回true,也不能跳过is_directory()检查——万一路径是个文件,is_empty仍会抛异常 - Windows 下对符号链接默认不跟随;Linux/macOS 行为一致,但若需显式控制,可用
std::filesystem::symlink_option::nofollow参数(仅限某些重载)
std::filesystem::is_empty 对目录和文件的处理逻辑不同
该函数重载支持两种输入:std::filesystem::path 和 std::filesystem::directory_entry。关键区别在于:
- 对
path调用时,内部会尝试打开目录并检查是否有至少一个条目(不含.和..) - 对
directory_entry调用时,若该 entry 已缓存了状态(比如来自std::filesystem::directory_iterator构造),可能避免重复系统调用,略快一点 - 但注意:
is_empty("some_dir")和is_empty(std::filesystem::directory_entry{"some_dir"})在语义上等价,性能差异微乎其微,除非你本就在遍历目录
示例(带防护):
namespace fs = std::filesystem;
try {
if (fs::exists(p) && fs::is_directory(p)) {
if (fs::is_empty(p)) {
// 目录存在、是目录、且为空
}
}
} catch (const fs::filesystem_error& e) {
// 处理权限拒绝、路径过长、无效字符等
}
替代方案:手动遍历 + 提前退出,更可控但稍啰嗦
如果你需要区分“目录不存在”“不是目录”“权限不足”“目录非空但无读取权限”等细节,is_empty 的异常模型反而不够精细。此时可手动用 directory_iterator 尝试取第一个元素:
- 构造
fs::directory_iterator时也会抛异常,所以仍需try - 成功构造后,直接比较
iter == fs::directory_iterator{}—— 若相等,说明没找到任何条目(即为空) - 只要迭代器能构造成功且首个
++iter就等于 end,则说明目录为空;否则非空 - 这个方法不会因目录里有隐藏文件(如
.git)而误判——is_empty本来也不忽略隐藏项,二者行为一致
编译与标准兼容性容易被忽略
std::filesystem 在 C++17 中作为 TS 引入,但早期 GCC/Clang 实现不完整。现在主流编译器基本没问题,但仍有坑:
- GCC 8.1+ 默认启用,但需链接
-lstdc++fs(GCC 9+ 可省略,但保险起见仍建议加) - MSVC 2017 15.7+ 支持,无需额外链接;但若项目设置为 ISO C++14 标准,即使头文件能包含,
is_empty也不会定义 - CMake 中要明确设
set(CMAKE_CXX_STANDARD 17),并检查target_link_libraries(your_target stdc++fs)(Linux/macOS) - 注意:某些嵌入式或精简 STL 实现(如 libc++ on older Android NDK)可能未实现
is_empty,此时只能回退到手动迭代
最易被忽略的一点:函数不检查挂载点是否可用——如果目录位于 NFS 或 FUSE 文件系统且服务中断,is_empty 会卡住或超时抛异常,而不是快速失败。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











