
从C++17开始,std::filesystem 成为标准库的一部分,提供了便捷的文件系统操作功能,比如遍历目录、创建/删除文件夹、检查路径属性等。使用它需要包含头文件并链接相应的库。
1. 基本配置与启用
要使用 std::filesystem,你需要:
- 编译器支持 C++17 或更高版本
- 包含头文件:#include
- 在 GCC/Clang 中可能需要手动链接 stdc++fs(新版通常不再需要)
示例编译命令(GCC):
g++ -std=c++17 your_file.cpp -o your_program2. 常用操作示例
命名空间别名可简化代码:
立即学习“C++免费学习笔记(深入)”;
namespace fs = std::filesystem;检查路径是否存在
判断某个文件或目录是否存在:
fs::path p = "example.txt";if (fs::exists(p)) {
std::cout }
判断是文件还是目录
通过 is_regular_file() 和 is_directory() 区分类型:
if (fs::is_regular_file(p)) {std::cout } else if (fs::is_directory(p)) {
std::cout }
创建和删除目录
创建单层目录:
fs::create_directory("new_folder"); // 目录已存在不会报错创建多级嵌套目录:
删除文件或目录:
fs::remove("old_file.txt"); // 删除单个文件fs::remove_all("temp_folder"); // 递归删除整个目录
遍历目录内容
使用 fs::directory_iterator 遍历目录中的每一项:
for (const auto& entry : fs::directory_iterator("my_folder")) {std::cout }
如果想递归进入子目录,使用 fs::recursive_directory_iterator:
for (const auto& entry : fs::recursive_directory_iterator("root")) {if (entry.is_regular_file()) {
std::cout }
}
获取文件信息
可以获取文件大小、最后修改时间等元数据:
uintmax_t size = fs::file_size("data.bin");auto time = fs::last_write_time("config.json");
注意:时间类型是 file_time_type,转换成人类可读格式需要额外处理(如转为 std::time_t)。
路径操作与拼接
fs::path 支持跨平台路径处理:
fs::path p1 = "/home/user";fs::path p2 = "documents/report.txt";
fs::path combined = p1 / p2; // 自动使用正确分隔符
std::cout
其他路径方法:
- p.filename() —— 获取文件名(含扩展名)
- p.stem() —— 获取文件名不含扩展名
- p.extension() —— 获取扩展名
- p.parent_path() —— 获取父目录路径
基本上就这些核心用法。std::filesystem 极大简化了原本依赖系统调用或第三方库的文件管理任务,推荐在 C++17+ 项目中优先使用。注意不同平台对权限、符号链接等行为可能略有差异。











