C++17 中的 std::filesystem 库：文件系统操作的新思路

作者

C++17 标准首次正式引入了 std::filesystem，为文件和目录的操作提供了一套统一、类型安全且跨平台的 API。相较于传统的 POSIX 系统调用或 Windows API，std::filesystem 更易读、易用，并且充分利用了 C++ 的异常安全和类型检查机制。下面从几个典型场景出发，详细剖析 std::filesystem 的使用方法和最佳实践。

1. 目录遍历

#include <iostream>
#include <filesystem>
namespace fs = std::filesystem;

int main() {
    fs::path dir = "/usr/local/bin";

    try {
        for (const auto& entry : fs::recursive_directory_iterator(dir)) {
            std::cout << (entry.is_directory() ? "[DIR] " : "[FILE] ") << entry.path() << '\n';
        }
    } catch (const fs::filesystem_error& e) {
        std::cerr << "访问错误: " << e.what() << '\n';
    }
}
  • 递归 vs 非递归：recursive_directory_iterator 递归遍历子目录；若只需一次遍历，使用 directory_iterator 即可。
  • 异常处理：任何 I/O 错误都抛出 std::filesystem_error，可通过 code() 获取 std::error_code 进一步判断。

2. 路径拼接与比较

fs::path p1 = "/var";
fs::path p2 = "log";
fs::path full = p1 / p2; // "/var/log"

if (fs::equivalent(full, "/var/log")) {
    std::cout << "路径相等\n";
}
  • operator/：便捷地拼接路径，内部会自动处理分隔符。
  • equivalent：不只比较字符串，还会考虑符号链接和大小写敏感性。

3. 读取和写入文件

#include <fstream>

fs::path file = "example.txt";

// 写入
std::ofstream ofs(file);
ofs << "Hello, std::filesystem!\n";
ofs.close();

// 读取
std::ifstream ifs(file);
std::string line;
while (std::getline(ifs, line)) {
    std::cout << line << '\n';
}
ifs.close();

std::filesystem 并不直接提供文件内容操作，建议配合 `

` 使用。但它能确保路径合法性和错误处理： “`cpp if (!fs::exists(file)) { std::cerr ` 转为 `time_t`。 – **权限**：`fs::status(p).permissions()` 结合 `std::filesystem::perms` 进行检查。 — ### 6. 交叉平台注意事项 | 功能 | Windows | POSIX | 说明 | |——|———|——-|——| | 路径分隔符 | `\` | `/` | `std::filesystem` 自动处理 | | 文件大小 | `std::uintmax_t` | 同 | 对应 `file_size` | | 软链接 | 支持 | 支持 | `symlink_status` 与 `status` 区别 | | 错误码 | `errno` | `errno` | 通过 `error_code` 统一包装 | > **Tip**：在 Windows 上使用 `std::filesystem::current_path()` 时，返回的是 `std::wstring`（UTF-16），而在 POSIX 是 `std::string`（UTF-8）。在跨平台项目中，建议统一使用 `fs::path::string()` 或 `string_view`。 — ### 7. 性能考量 虽然 `std::filesystem` 在语义上简洁，但在高并发或大规模文件操作时，底层实现仍依赖操作系统的系统调用。若需要极致性能，可考虑： – **批量操作**：一次性读取目录列表后再批量处理。 – **异步 I/O**：结合 `std::async` 或平台特定异步 API。 – **缓存**：对频繁访问的文件路径使用 `std::unordered_map` 缓存。 — ### 8. 结语 `std::filesystem` 为 C++ 开发者提供了一个统一、现代的文件系统接口，极大地降低了平台差异带来的开发负担。掌握其核心 API 后，几乎所有日常的文件/目录操作都能用几行代码完成，并享受异常安全和类型检查带来的好处。随着 C++20 的进一步扩展，更多高效、简洁的文件系统工具将陆续加入标准库，值得持续关注。 —

发表评论