Boost.Filesystem 用于 C++：文件系统操作完整指南

\n\n

Boost.Filesystem 是一个功能强大且成熟的 C++ 库，提供了可移植（跨平台）的文件系统操作接口。它是 Boost 库集合的一部分，实际上已成为 C++17 标准库 <filesystem> 的原型。如果您使用 C++11 或 C++14，并且需要一个可靠、久经考验的工具来处理路径、文件和目录，Boost.Filesystem 是您的不二之选。

\n\n

为什么需要它？长期以来，标准 C++ 缺乏用于检查文件是否存在、创建目录或递归遍历文件夹等简单任务的内置工具。开发人员不得不在 Linux 上使用 stat()，在 Windows 上使用 GetFileAttributes()，这导致代码不可移植。Boost.Filesystem 通过提供在所有主流平台上运行一致的统一 API 解决了这个问题。该库封装了系统调用，处理路径编码（例如 Linux 上的 UTF-8 和 Windows 上的 UTF-16），并提供了方便的类来处理路径和遍历目录。

\n\n

在本文中，我们将详细讲解库的安装、主要类和方法，并提供一个您可以在项目中使用的实际示例。我们将重点介绍 Boost 1.84 版本（撰写本文时的最新版本），但示例也适用于更旧的版本。

\n\n

安装 Boost.Filesystem

\n\n

与具有包管理器（npm、pip）的语言不同，C++ 需要编译库。Boost.Filesystem 仅部分为 header-only 库；处理文件需要编译后的库（libboost_filesystem）。

\n\n

通过包管理器安装（推荐）

\n\n

Ubuntu/Debian (Linux)：

\n

sudo apt update\nsudo apt install libboost-filesystem-dev

\n\n

macOS (Homebrew)：

\n

brew install boost

\n\n

Windows (vcpkg)：

\n

vcpkg install boost-filesystem

\n\n

从源码编译（如果没有包管理器）

\n

# 从官网下载 Boost\nwget https://boostorg.jfrog.io/artifactory/main/release/1.84.0/source/boost_1_84_0.tar.gz\ntar -xzf boost_1_84_0.tar.gz\ncd boost_1_84_0\n\n# 运行 bootstrap\n./bootstrap.sh\n\n# 仅编译 filesystem 库（节省时间）\n./b2 --with-filesystem\n\n# 安装（通常到 /usr/local）\nsudo ./b2 install

\n\n

使用 Boost.Filesystem 编译项目

\n

编译时需要指定头文件路径并链接库：

\n

g++ -std=c++11 -I/path/to/boost main.cpp -lboost_filesystem -lboost_system -o my_program

\n\n

快速入门：最小工作示例

\n\n

让我们编写一个简单的程序，检查文件是否存在并输出其大小。

\n\n

#include <iostream>\n#include <boost/filesystem.hpp>\n\nnamespace fs = boost::filesystem;\n\nint main() {\n    // 文件路径\n    fs::path file_path("example.txt");\n\n    // 检查文件是否存在\n    if (fs::exists(file_path)) {\n        // 获取文件大小\n        uintmax_t file_size = fs::file_size(file_path);\n        std::cout << "文件：" << file_path.filename() << std::endl;\n        std::cout << "大小：" << file_size << " 字节" << std::endl;\n    } else {\n        std::cout << "文件未找到。" << std::endl;\n    }\n\n    return 0;\n}

\n\n

这段代码展示了三个关键功能：创建路径对象（fs::path）、检查