博主介绍程序喵大人35 - 资深C/C/Rust/Android/iOS客户端开发10年大厂工作经验嵌入式/人工智能/自动驾驶/音视频/游戏开发入门级选手《C20高级编程》《C23高级编程》等多本书籍著译者更多原创精品文章首发gzh见文末记得订阅专栏以防走丢C基础系列专栏C语言基础系列专栏C大佬养成攻略专栏C训练营个人网站在C17标准引入之前不同操作系统有着不同的文件系统API这使得跨平台文件操作变得异常复杂。我们需要编写大量的条件编译代码来适配不同的平台不仅增加了代码的复杂度还降低了代码的可维护性。C17引入的库基于Boost.Filesystem应运而生它提供了一套统一、可移植且高效的API将路径、目录、文件属性等概念封装为RAII对象支持Unicode、符号链接、权限管理并与C标准库无缝集成比原来的C方法好用的多。但我估计C17之前很多人文件操作也是会用Boost.Filesystem包括限制应该也有挺多人在用Boost核心组件概述核心组件组件作用path路径的抽象表示支持Unicode、自动规范化directory_entry目录项含路径 文件状态缓存directory_iterator/recursive_directory_iterator目录遍历迭代器file_status/space_info文件属性与磁盘空间信息操作函数exists,is_regular_file,create_directory,copy,remove等核心价值C17的filesystem库的核心价值在于实现了“一次编写处处运行Write Once, Run Anywhere”。它抽象了不同操作系统之间的文件系统差异使得开发者可以使用统一的API进行文件系统操作无需再为不同的平台编写不同的代码。路径操作智能路径对象std::filesystem::pathstd::filesystem::path是C17引入的路径操作核心类提供跨平台的路径构建、解析与拼接能力。它抽象了不同操作系统间的路径差异如Windows使用反斜杠\而Unix - like系统使用正斜杠/。路径构造与赋值#includefilesystemnamespacefsstd::filesystem;fs::path p1/home/user/data.txt;// POSIXfs::path p2R(C:\Users\user\data.txt);// Windowsfs::path p3u8数据/文件.txt;// UTF - 8 支持// 自动处理分隔符fs::path p4dir/subdir/file.txt;// 推荐使用 / 操作符路径分解与查询fs::path p/usr/local/bin/app.exe;p.root_name();// (POSIX) 或 C: (Windows)p.root_directory();// /p.parent_path();// /usr/local/binp.filename();// app.exep.stem();// appp.extension();// .exep.is_absolute();// truep.has_extension();// true跨平台关键行为操作POSIXWindowspath(/a) / b/a/b\a\bpath(C:) / fileC:/fileC:\filepath::preferred_separator/\\最佳实践永远使用/操作符拼接路径库会自动转换这样可以避免手动处理不同平台的路径分隔符提高代码的可移植性。目录遍历传统跨平台目录遍历代码的困境在C17之前传统的跨平台目录遍历代码需要大量的条件编译以适配不同的操作系统。例如在Windows平台上使用FindFirstFile和FindNextFile函数而在Linux/Unix平台上使用opendir和readdir函数。这种方式不仅代码复杂而且容易出现资源泄漏等问题。C17的解决方案基础用法#includefilesystemnamespacefsstd::filesystem;// 引入命名空间别名,让代码更简洁// 基础文件操作fs::create_directory(新建文件夹);// 创建目录,不再需要平台判断创建目录// 智能路径处理fs::path userPathfs::current_path()/docs/test.txt;// 解释:// - current_path() 获取当前工作目录// - 使用 / 运算符自动处理不同平台的路径分隔符// - Windows上会自动转换为反斜杠std::cout标准化路径: userPath\n;遍历目录// 目录遍历示例for(constautoentry:fs::directory_iterator(新建文件夹)){// 获取每个文件/目录的信息std::coutentry.path().filename()\n;// 仅输出文件名// 文件属性查询if(fs::is_regular_file(entry)){// 检查是否为普通文件autofileSizefs::file_size(entry);// 获取文件大小std::cout大小: fileSize bytes\n;autolastWritefs::last_write_time(entry);// 最后修改时间// 时间格式化需要额外处理}}递归遍历目录// 递归遍历目录for(constautoentry:fs::recursive_directory_iterator(项目目录)){// recursive_directory_iterator的特点:// - 自动遍历所有子目录// - 深度优先搜索// - 自动处理符号链接if(entry.is_regular_file()entry.path().extension().cpp){std::cout找到 C 源文件entry.path()\n;}}性能优势directory_iterator和recursive_directory_iterator内部实现采用批处理机制减少系统调用比传统的目录遍历方法更高效。同时directory_entry缓存状态信息避免对每个文件重复调用stat。文件属性文件属性查询C17的filesystem库提供了丰富的函数来查询文件属性如文件大小、最后修改时间、文件类型等。获取文件大小和最后修改时间fs::path pfile.txt;if(fs::exists(p)){std::cout文件大小: fs::file_size(p) 字节std::endl;autolastWritefs::last_write_time(p);// 时间格式化需要额外处理}判断文件类型// 文件类型判断if(fs::is_regular_file(p1)){// 普通文件检查std::cout这是普通文件\n;}elseif(fs::is_directory(p1)){// 目录检查std::cout这是目录\n;}elseif(fs::is_symlink(p1)){// 符号链接检查std::cout这是符号链接\n;}文件状态检查// 文件状态检查 - 推荐的检查顺序if(fs::exists(config.json)){// 先检查文件存在性避免后续操作出错if(fs::is_regular_file(config.json)){// 进一步确认文件类型// - 不是目录// - 不是符号链接// - 不是特殊文件std::cout是个普通文件呢\n;}}获取磁盘信息fs::space_info sifs::space(/);std::cout总空间: si.capacity bytes\n空闲: si.free bytes\n可用: si.available bytes\n;符号链接处理创建符号链接软链接 (Symbolic Link / Soft Link)std::filesystem::create_symlink(target,link_path);// 创建指向 target 文件或目录的软链接 link_path。如果 target 不存在链接仍可创建但会是一个“悬空”链接。std::filesystem::create_directory_symlink(target,link_path);// 专用于创建指向目录的软链接行为与 create_symlink 类似但意图更明确。硬链接 (Hard Link)std::filesystem::create_hard_link(target,link_path);// 创建指向 target 文件的硬链接 link_path。硬链接是文件系统中的一个额外目录项指向同一个inode文件内容。它要求 target 必须是一个已存在的文件且 target 和 link_path 必须位于同一个文件系统分区上。硬链接不能指向目录。解析符号链接std::filesystem::read_symlink(link_path);// 读取符号链接 link_path 所指向的直接目标路径。这个路径可能是相对路径也可能是一个不存在的路径。它只解析一层链接。std::filesystem::canonical(path);// 解析 path返回其绝对的、不包含任何符号链接的规范化路径。它会递归地解析所有符号链接并处理 .. 和 . 等路径组件最终返回一个指向真实文件系统对象的路径。如果路径不存在或存在循环链接可能会抛出异常。常见陷阱悬空链接创建软链接时如果目标不存在链接仍可创建但会是一个“悬空”链接。在使用时需要注意判断目标是否存在。硬链接限制硬链接不能指向目录也不能跨越不同的文件系统即不同的磁盘分区或挂载点。权限问题在某些操作系统上创建符号链接可能需要特定的用户权限。例如在Windows上非管理员用户可能无法创建符号链接。read_symlink与canonical混淆read_symlink只读取链接本身指向的下一跳路径这个路径可能是相对的也可能仍然是一个链接。它不会递归解析。而canonical则是“追根溯源”它会一直解析直到找到一个非链接的真实文件或目录并且返回一个绝对路径。循环链接异常文件系统中可能存在符号链接循环A - B - C - A。canonical在遇到这种循环时可能会抛出std::filesystem::filesystem_error异常。跨平台实现跨平台注意事项路径分隔符处理Windows使用\作为路径分隔符但std::filesystem::path会自动将/转换为\。POSIX使用/作为路径分隔符std::filesystem::path会保持原样。大小写敏感性Windows路径大小写不敏感而Linux/macOS路径大小写敏感。常见问题与解决方案路径拼接错误问题手动拼接路径可能导致分隔符错误如C:/Users/Example\file.txt。解决方案使用std::filesystem::path的/操作符自动适配分隔符。权限不足导致的操作失败问题尝试删除或修改受保护的文件或目录时抛出异常。解决方案使用try - catch捕获异常或检查错误码。在操作系统中提升权限后再执行操作。递归遍历性能问题问题recursive_directory_iterator可能因大量文件导致性能下降。解决方案添加过滤条件减少遍历范围。在非实时场景中异步处理。跨平台代码示例#includefilesystem#includeiostreamnamespacefsstd::filesystem;intmain(){fs::path p1C:/Users/Example;// Windows 路径fs::path p2/home/user/documents;// Linux 路径fs::path p3p1/data/file.txt;// 自动适配系统分隔符std::coutPath: p3std::endl;std::coutNative path: p3.native()std::endl;// 显示系统原生格式return0;}码字不易欢迎大家点赞关注评论谢谢