std::filesystem 是 C++17 引入的标准库模块,用于跨平台的文件和目录操作。它替代了过去依赖系统 API 或 Boost.Filesystem 的做法,接口清晰、类型安全、异常友好。
使用前需包含头文件并处理命名空间:
#include
using namespace std::filesystem;
注意:某些编译器(如 GCC 8+、Clang 7+、MSVC 2017 Update 5+)默认支持,但 GCC 需链接 -lstdc++fs(CMake 中加 target_link_libraries(target stdc++fs))。
所有操作都围绕 std::filesystem::path 展开,它自动处理不同系统的路径分隔符(/ 或 \):
path p = "data/config.txt"; 或 path p("logs", "app.log");
p /= "backup"; 或 p = p / "v2" / "temp.dat";
p.parent_path()、p.filename()、p.extension()
canonical(p)(解析 . 和 ..,需路径存在)或 weakly_canonical(p)(即使部分不存在也尝试规整)用 exists()、is_regular_file()、is_directory() 等函数快速判断:
if (exists("co
nfig.json")) { ... }if (is_directory("src/")) { ... }if (is_regular_file("log.txt") && file_size("log.txt") > 1024) { ... }last_write_time(p) 返回 file_time_type;file_size(p) 返回 uintmax_t 字节大小这些操作默认抛出 filesystem_error 异常,也可用带 error_code 参数的重载避免异常:
create_directory("build");(仅一级),create_directories("a/b/c");(递归创建)copy_file("src.txt", "dst.txt", copy_options::overwrite_existing);
rename("old.log", "new.log");
remove("temp.bin");(文件或空目录),remove_all("cache/");(递归删除整个目录树)类似 STL 迭代器风格,支持范围 for:
for (const auto& entry : directory_iterator("src")) { cout
for (const auto& entry : recursive_directory_iterator("project")) { ... }
recursive_directory_iterator(p, directory_options::skip_permission_denied)
基本上就这些。实际使用时注意权限、路径存在性、异常处理,多数操作都有非抛出版本(带 std::error_code& 参数),适合嵌入式或容错要求高的场景。