
要在 C++ 中使用 std::filesystem 库操作文件系统,需要确保编译器支持 C++17 及以上标准,并正确链接文件系统库。这个库提供了便捷的接口来处理路径、文件和目录操作,比如创建、删除、遍历、判断类型等。
启用 std::filesystem 支持
要使用 std::filesystem,需满足以下条件:
- 编译器支持 C++17 或更高版本(如 GCC 8+、Clang 7+、MSVC 2017+)
- 包含头文件:#include
- 在 GCC/Clang 下可能需要手动链接 -lstdc++fs(旧版本),新版本通常不再需要
示例编译命令(GCC):
g++ -std=c++17 your_file.cpp -o your_program基本用法:路径操作与文件状态
std::filesystem::path 是核心类,用于表示路径,支持跨平台分隔符自动处理(Windows 用反斜杠,Linux/macOS 用正斜杠)。
立即学习“C++免费学习笔记(深入)”;
常用路径操作:
- path.filename() — 获取文件名
- path.stem() — 获取不带扩展名的文件名
- path.extension() — 获取扩展名
- path.parent_path() — 获取父目录路径
- path.is_absolute() — 判断是否为绝对路径
示例代码:
#include#include iostream>
namespace fs = std::filesystem;
int main() {
fs::path p = "/home/user/documents/report.txt";
std::cout std::cout std::cout std::cout
return 0;
}
文件与目录操作
通过 std::filesystem 可以轻松管理文件和目录:
常见操作函数:
- fs::exists(path) — 路径是否存在
- fs::is_regular_file(path) — 是否是普通文件
- fs::is_directory(path) — 是否是目录
- fs::create_directory(path) — 创建单个目录
- fs::create_directories(path) — 创建多级目录(自动创建中间目录)
- fs::remove(path) — 删除文件或空目录
- fs::remove_all(path) — 递归删除目录及其内容
- fs::copy(source, target) — 复制文件或目录
- fs::rename(old_path, new_path) — 重命名或移动
示例:创建并检查目录
if (!fs::exists("my_folder")) {fs::create_directory("my_folder");
std::cout } else {
std::cout }
遍历目录内容
使用 fs::directory_iterator 或 fs::recursive_directory_iterator 遍历目录。
directory_iterator:仅当前层级
for (const auto& entry : fs::directory_iterator("my_folder")) {std::cout }
recursive_directory_iterator:递归遍历子目录
for (const auto& entry : fs::recursive_directory_iterator("my_folder")) {if (fs::is_regular_file(entry)) {
std::cout } else if (fs::is_directory(entry)) {
std::cout }
}
基本上就这些。std::filesystem 让 C++ 的文件系统操作变得直观且跨平台兼容,避免了依赖系统 API。只要注意编译设置和异常处理(多数函数在失败时抛出异常),就能高效完成各类文件管理任务。











