C++文件与目录操作：现代C++17 filesystem库实战指南

1. 为什么C++开发者必须掌握文件与目录操作

在C++开发者的日常工作中，文件与目录操作就像木匠手中的锯子和锤子一样基础而重要。你可能已经熟练掌握了C++的面向对象特性、模板元编程等高级技巧，但如果不能有效处理文件系统，就像赛车手不会换轮胎一样尴尬。

我见过太多这样的场景：一个性能优异的算法因为文件IO处理不当导致整体效率下降；一个本该自动化的流程因为目录操作不完善需要人工干预；甚至有些安全漏洞就源于对文件权限的疏忽。这些问题的根源往往在于开发者对C++文件系统操作的掌握不够系统。

现代C++（C++17及以上）提供了完整的<filesystem>库，这比传统的C风格文件操作（fopen/fread等）更加类型安全且符合现代C++的设计哲学。但在此之前，开发者不得不混合使用C标准库、平台API（如Windows的CreateFile）或第三方库（如Boost.Filesystem）。这种历史沿革导致了很多混乱和兼容性问题。

关键认知：文件操作不仅仅是读写数据，还包括权限管理、错误处理、跨平台兼容性等系统工程问题。目录操作也不只是创建删除文件夹，更涉及遍历策略、路径解析等复杂场景。

2. 现代C++文件操作核心API详解

2.1 文件流的三驾马车

C++标准库提供了三种文件流类，各自针对不同的使用场景：

1. std::ifstream：输入文件流，用于读取文件

   cpp复制std::ifstream in("data.bin", std::ios::binary);
   if(!in) throw std::runtime_error("无法打开文件");
   
   char buffer[1024];
   while(in.read(buffer, sizeof(buffer))) {
       // 处理读取的数据
   }
   

2. std::ofstream：输出文件流，用于写入文件

   cpp复制std::ofstream out("log.txt", std::ios::app);  // 追加模式
   if(out.is_open()) {
       out << "[" << std::chrono::system_clock::now() << "] "
           << "日志内容" << std::endl;
   }
   

3. std::fstream：双向文件流，支持读写混合操作

   cpp复制std::fstream db("database.dat", 
                  std::ios::binary | std::ios::in | std::ios::out);
   db.seekp(0, std::ios::end);  // 移动到文件末尾
   db.write(reinterpret_cast<const char*>(&record), sizeof(Record));
   

2.2 文件打开模式详解

文件流的构造函数和open()方法都接受模式参数，这些标志位可以通过按位或组合使用：

常见坑点：Windows平台下文本模式会转换换行符（\n → \r\n），处理二进制文件时务必指定binary模式。

2.3 文件状态检测与错误处理

正确的错误处理是健壮文件操作的关键。以下是一个完整的检查链：

cpp复制std::ifstream file("important.data");
if(!file.is_open()) {
    // 文件未打开
    std::cerr << "打开文件失败: " << strerror(errno) << std::endl;
} 
else if(file.peek() == std::ifstream::traits_type::eof()) {
    // 文件为空
    std::cout << "警告: 文件为空" << std::endl;
}
else {
    try {
        // 正常处理逻辑
    } 
    catch(const std::ios_base::failure& e) {
        std::cerr << "IO异常: " << e.what() 
                 << ", 错误码: " << e.code() << std::endl;
    }
}

3. C++17 filesystem库实战

3.1 路径操作的艺术

std::filesystem::path类提供了跨平台的路径处理能力：

cpp复制namespace fs = std::filesystem;

// 构造路径（自动处理平台分隔符）
fs::path data_dir = "C:/ProgramData/MyApp";  // Windows
fs::path config_file = "/etc/myapp.conf";    // Linux

// 路径拼接（更安全的方式）
auto full_path = data_dir / "subdir" / "data.bin";

// 获取路径各部分
std::cout << "根目录: " << full_path.root_name() << "\n"
          << "父目录: " << full_path.parent_path() << "\n"
          << "文件名: " << full_path.filename() << "\n"
          << "扩展名: " << full_path.extension() << std::endl;

3.2 文件系统操作大全

以下表格总结了最常用的文件系统操作：