
在C++17中,std::filesystem 成为标准库的一部分,提供了便捷的文件系统操作功能,如路径处理、目录遍历、文件状态查询、创建/删除目录等。该库位于
路径操作:std::filesystem::path
std::filesystem::path 是路径操作的核心类,支持跨平台路径表示和拼接。
常见用法包括:
- 构造路径:支持字符串、wstring、其他 path 对象
- 路径拼接:使用 / 运算符或 concat()、append()
- 分解路径:获取文件名、扩展名、父目录、根路径等
#include#include namespace fs = std::filesystem; int main() { fs::path p = "/home/user/documents/report.txt"; std::cout << "文件名: " << p.filename() << '\n'; // report.txt std::cout << "文件名无扩展: " << p.stem() << '\n'; // report std::cout << "扩展名: " << p.extension() << '\n'; // .txt std::cout << "父目录: " << p.parent_path() << '\n'; // /home/user/documents fs::path new_path = p.parent_path() / "image.jpg"; std::cout << "新路径: " << new_path << '\n'; }
文件与目录状态检查
通过 fs::status() 或 fs::symlink_status() 获取文件属性,结合 fs::file_status 判断类型。
立即学习“C++免费学习笔记(深入)”;
常用判断函数:
- fs::exists(path):路径是否存在
- fs::is_regular_file(path):是否是普通文件
- fs::is_directory(path):是否是目录
- fs::is_symlink(path):是否是符号链接
- fs::file_size(path):获取文件大小(字节)
fs::path test_file = "example.txt";
if (fs::exists(test_file)) {
if (fs::is_regular_file(test_file)) {
std::cout << "文件大小: " << fs::file_size(test_file) << " 字节\n";
}
} else {
std::cout << "文件不存在\n";
}
目录遍历:fs::directory_iterator
使用 fs::directory_iterator 遍历目录中的条目。
支持范围 for 循环,每个迭代项为 fs::directory_entry,包含路径和缓存的状态信息。
示例代码:
fs::path dir = ".";
for (const auto& entry : fs::directory_iterator(dir)) {
if (fs::is_regular_file(entry.status())) {
std::cout << "[文件] " << entry.path().filename() << '\n';
} else if (fs::is_directory(entry.status())) {
std::cout << "[目录] " << entry.path().filename() << '\n';
}
}
若需递归遍历子目录,使用 fs::recursive_directory_iterator:
for (const auto& entry : fs::recursive_directory_iterator(dir)) {
std::cout << entry.path() << '\n';
}
目录与文件操作
std::filesystem 提供了创建、删除、重命名等实用函数:
- fs::create_directory(path):创建单个目录
- fs::create_directories(path):递归创建多级目录
- fs::remove(path):删除文件或空目录
- fs::remove_all(path):递归删除目录及其内容
- fs::rename(old, new):重命名或移动文件/目录
// 创建多级目录
fs::create_directories("data/temp/cache");
// 删除整个目录树
fs::remove_all("data/temp");
// 重命名文件
fs::rename("old_name.txt", "new_name.txt");
基本上就这些。std::filesystem 简化了传统 C 风格或第三方库的复杂操作,提供类型安全、异常处理和跨平台兼容性。只要注意编译选项开启 C++17,并链接必要的系统库(如 Linux 下可能需要 -lstdc++fs 旧版本),就能顺利使用。










