
在C++17之前,处理文件和目录的操作非常繁琐,标准库并没有提供原生支持,开发者往往依赖于平台相关的API(如POSIX或Windows API)或第三方库。从C++17开始,std::filesystem 被引入标准库,为文件系统操作提供了统一、跨平台的现代化接口。它极大简化了路径处理、目录遍历、文件属性查询等常见任务。
包含头文件与启用命名空间
使用 std::filesystem 需要包含对应的头文件,并建议使用命名空间以减少重复书写:
#includenamespace fs = std::filesystem;
注意:某些编译器(如旧版GCC)可能要求启用特定标准并链接 -lstdc++fs,但在C++17及以上版本中通常已集成。
路径操作:fs::path 的灵活使用
fs::path 是文件系统库的核心类,用于表示路径,支持跨平台分隔符自动转换(如Windows用反斜杠,Linux用正斜杠)。
立即学习“C++免费学习笔记(深入)”;
常见用法包括:
- 构造路径:
fs::path p = "/home/user/docs";或拼接p /= "file.txt"; - 获取路径组件:
p.filename()、p.stem()(文件名不含扩展)、p.extension()(扩展名) - 判断路径类型:
p.has_extension()、p.is_absolute()
路径对象可直接用于大多数文件系统函数,是类型安全且易于操作的基础。
文件与目录状态查询
通过 fs::status() 和 fs::file_status 可以获取文件或目录的元信息。
常用判断函数:
-
fs::exists(path):检查路径是否存在 -
fs::is_regular_file(path):是否为普通文件 -
fs::is_directory(path):是否为目录 -
fs::is_empty(path):是否为空(文件大小为0或目录无内容) -
fs::file_size(path):获取文件字节大小(仅对普通文件有效)
这些函数返回布尔值或具体数值,便于编写条件逻辑。
目录遍历与迭代
使用 fs::directory_iterator 可遍历目录中的每一项。
示例:打印某目录下所有条目名称
for (const auto& entry : fs::directory_iterator("/tmp")) {
std::cout << entry.path() << "\n";
}
若需递归遍历子目录,使用 fs::recursive_directory_iterator,行为类似深度优先搜索。
迭代器解引用返回 directory_entry 对象,可通过其方法快速访问状态和路径,避免重复查询。
创建、重命名与删除操作
std::filesystem 提供了简洁的文件系统修改接口:
-
fs::create_directory(path):创建单个目录 -
fs::create_directories(path):递归创建多级目录(自动创建父目录) -
fs::rename(old_path, new_path):重命名或移动文件/目录 -
fs::remove(path):删除文件或空目录 -
fs::remove_all(path):递归删除目录及其全部内容
这些操作均返回布尔值表示是否成功,部分会抛出异常(取决于是否使用 _nothrow 版本)。
基本上就这些。std::filesystem 让C++的文件操作变得直观又安全,不再需要写一堆平台适配代码。只要记得编译时开启 -std=c++17,用起来很顺手。











