C++中的std::filesystem库怎么用_C++文件系统操作与std::filesystem使用指南

c++kquote>std::filesystem是C++17引入的跨平台文件系统库,用于统一处理路径、文件和目录操作。通过包含头文件并使用命名空间std::filesystem,可实现路径拼接、文件状态判断、目录遍历等功能。核心类path支持自动转换路径分隔符,提供filename、stem、extension等方法解析路径;exists、is_regular_file、is_directory等函数用于检查文件属性;需编译器支持C++17标准,如g++ -std=c++17。

std::filesystem 是 C++17 引入的标准库,用于处理文件和目录操作。它替代了传统依赖平台的 API(如 POSIX 或 Windows API),提供跨平台的统一接口。通过 std::filesystem,你可以轻松实现路径管理、文件读写判断、目录遍历、创建删除等常见操作。

包含头文件与命名空间

使用 std::filesystem 前,需包含头文件并引入命名空间:

#include
#include iostream>

namespace fs = std::filesystem;

注意:编译时需启用 C++17 或更高标准。例如用 g++ 编译:

g++ -std=c++17 main.cpp -o main

路径操作:std::filesystem::path

path 是 std::filesystem 的核心类,用于表示文件或目录路径,支持跨平台分隔符自动转换(/ 或 \)。

常用操作示例:

  • 构造路径:
    fs::path p = "/home/user/test.txt";
  • 拼接路径:
    fs::path p2 = p / "subdir" / "file.txt";
  • 获取路径各部分:
    p.filename(); // 返回 "test.txt"
    p.stem(); // 返回 "test"
    p.extension(); // 返回 ".txt"
    p.parent_path(); // 返回 "/home/user"
  • 检查是否为绝对路径:
    p.is_absolute();

文件与目录状态判断

通过 fs::status 或 fs::exists 可判断文件或目录是否存在及其类型。

常见判断函数:

  • fs::exists(p); // 是否存在
  • fs::is_regular_file(p); // 是否是普通文件
  • fs::is_directory(p); // 是否是目录
  • fs::is_empty(p); // 是否为空(文件大小为0或目录无内容)
  • fs::file_size(p); // 获取文件字节数(仅对文件有效)

示例:

if (fs::exists("config.json")) {
  if (fs::is_regular_file("config.json")) {
    std::cout   }
}

目录遍历:使用 directory_iterator

遍历目录中的所有条目,可用 fs::directory_iterator。

for (const auto& entry : fs::directory_iterator(".")) {
  std::cout   if (entry.is_directory()) std::cout   else if (entry.is_regular_file()) std::cout   std::cout }

若需递归遍历子目录,使用 fs::recursive_directory_iterator:

for (const auto& entry : fs::recursive_directory_iterator("/data")) {
  if (entry.path().extension() == ".log") {
    std::cout   }
}

创建、重命名与删除文件/目录

std::filesystem 提供简洁的函数进行文件系统修改。

  • 创建目录:
    fs::create_directory("new_folder");
    创建多级目录:
    fs::create_directories("a/b/c");
  • 重命名:
    fs::rename("old_name.txt", "new_name.txt");
  • 删除文件或空目录:
    fs::remove("temp.txt");
  • 删除目录及内容(递归):
    fs::remove_all("folder_to_delete");

这些操作返回 bool 值表示是否成功,也可捕获异常处理错误:

try {
  fs::create_directory("test");
} catch (const fs::filesystem_error& e) {
  std::cerr }

基本上就这些。std::filesystem 让 C++ 的文件操作变得直观且安全。只要注意编译器支持和 C++ 标准版本,就能写出可移植的代码。不复杂但容易忽略的是权限问题和异常处理,实际项目中建议始终包裹关键操作在 try-catch 中。