c++17中std::filesystem库的用法_c++17文件系统操作与路径管理示例

在C++17中，std::filesystem 成为标准库的一部分，提供了便捷的文件系统操作功能，如路径处理、目录遍历、文件状态查询、创建/删除目录等。该库位于 头文件中，使用前需确保编译器支持 C++17 并启用相关选项（如 GCC/Clang 使用 -std=c++17）。

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

std::filesystem::path 是路径操作的核心类，支持跨平台路径表示和拼接。

常见用法包括：

• 构造路径：支持字符串、wstring、其他 path 对象
• 路径拼接：使用 / 运算符或 concat()、append()
• 分解路径：获取文件名、扩展名、父目录、根路径等

#include 
#include 

namespace fs = std::filesystem;

int main() {
    fs::path p = "/home/user/documents/report.txt";

    std::cout << "文件名: " << p.filename() << '\n';         // report.txt
    std::cout << "文件名无扩展: " << p.stem() << '\n';       // report
    std::cout << "扩展名: " << p.extension() << '\n';        // .txt
    std::cout << "父目录: " << p.parent_path() << '\n';     // /home/user/documents

    fs::path new_path = p.parent_path() / "image.jpg";
    std::cout << "新路径: " << new_path << '\n';
}

文件与目录状态检查

通过 fs::status() 或 fs::symlink_status() 获取文件属性，结合 fs::file_status 判断类型。

常用判断函数：

• fs::exists(path)：路径是否存在
• fs::is_regular_file(path)：是否是普通文件
• fs::is_directory(path)：是否是目录
• fs::is_symlink(path)：是否是符号链接
• fs::file_size(path)：获取文件大小（字节）

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

if (fs::exists(test_file)) {
    if (fs::is_regular_file(test_file)) {
        std::cout << "文件大小: " << fs::file_size(test_file) << " 字节\n";
    }
} else {
    std::cout << "文件不存在\n";
}

目录遍历：fs::directory_iterator

使用 fs::directory_iterator 遍历目录中的条目。

支持范围 for 循环，每个迭代项为 fs::directory_entry，包含路径和缓存的状态信息。

fs::path dir = ".";

for (const auto& entry : fs::directory_iterator(dir)) {
    if (fs::is_regular_file(entry.status())) {
        std::cout << "[文件]  " << entry.path().filename() << '\n';
    } else if (fs::is_directory(entry.status())) {
        std::cout << "[目录]  " << entry.path().filename() << '\n';
    }
}

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

for (const auto& entry : fs::recursive_directory_iterator(dir)) {
    std::cout << entry.path() << '\n';
}

目录与文件操作

std::filesystem 提供了创建、删除、重命名等实用函数：

• fs::create_directory(path)：创建单个目录
• fs::create_directories(path)：递归创建多级目录
• fs::remove(path)：删除文件或空目录
• fs::remove_all(path)：递归删除目录及其内容
• fs::rename(old, new)：重命名或移动文件/目录

// 创建多级目录
fs::create_directories("data/temp/cache");

// 删除整个目录树
fs::remove_all("data/temp");

// 重命名文件
fs::rename("old_name.txt", "new_name.txt");

基本上就这些。std::filesystem 简化了传统 C 风格或第三方库的复杂操作，提供类型安全、异常处理和跨平台兼容性。只要注意编译选项开启 C++17，并链接必要的系统库（如 Linux 下可能需要 -lstdc++fs 旧版本），就能顺利使用。