C++目录操作实现 创建删除遍历目录

夜明大大_1639

夜明大大_1639

2025-08-20

886人浏览

原创

C++17的模块通过统一跨平台API、提供路径安全操作和异常处理机制,简化了目录的创建、删除与遍历,避免了系统差异和字符串误操作,成为现代C++文件系统操作的首选方案。

c++目录操作实现 创建删除遍历目录

C++中对目录进行创建、删除和遍历,在现代C++(特别是C++17及更高版本)中,主要通过标准库中的

<filesystem></filesystem>

模块来实现。这个模块提供了一套跨平台、面向对象的API,极大地简化了之前需要依赖操作系统特定API的繁琐工作,让目录操作变得直观且富有表现力。

解决方案

要实现C++的目录操作,我们推荐使用C++17引入的

std::filesystem

库。它提供了强大的工具,能够优雅地处理目录的创建、删除和内容遍历。

创建目录

使用

std::filesystem::create_directory

创建单个目录,或者

std::filesystem::create_directories

创建包含父目录在内的多级目录。后者在父目录不存在时会自动创建,非常方便。

#include <iostream>
#include <filesystem> // C++17

void create_directories_example() {
    std::filesystem::path dir_path = "my_new_dir/sub_dir";
    try {
        if (std::filesystem::create_directories(dir_path)) {
            std::cout <p><strong>删除目录</strong></p>
<p></p>
<pre class="brush:php;toolbar:false;">std::filesystem::remove

可以删除一个空目录或文件。如果需要删除非空目录及其所有内容,则需要使用

std::filesystem::remove_all

。使用

remove_all

时要格外小心,因为它会无情地清除指定路径下的所有内容。

#include <iostream>
#include <filesystem>

void remove_directories_example() {
    std::filesystem::path dir_to_delete = "my_new_dir"; // 假设这个目录存在且可能非空
    try {
        if (std::filesystem::exists(dir_to_delete)) {
            // remove_all 返回删除的条目数量
            std::uintmax_t removed_count = std::filesystem::remove_all(dir_to_delete);
            std::cout <p><strong>遍历目录</strong></p>
<p></p>
<pre class="brush:php;toolbar:false;">std::filesystem::directory_iterator

用于非递归地遍历一个目录中的直接子项(文件和子目录),而

std::filesystem::recursive_directory_iterator

则可以递归地遍历一个目录及其所有子目录中的所有文件和目录。

#include <iostream>
#include <filesystem>
#include <string>

void traverse_directory_example() {
    std::filesystem::path target_dir = "."; // 遍历当前目录
    std::cout  " <h3>为什么C++17 <pre class="brush:php;toolbar:false;"><filesystem></filesystem>
模块是现代C++目录操作的首选?

在C++17之前,处理文件系统操作一直是个令人头疼的问题。标准库在这方面是空白的,这意味着开发者不得不依赖于操作系统特定的API,比如Windows上的

CreateDirectory

、

Windows 服务器运维工具箱
Windows 服务器运维工具箱

Windows 服务器运维工具箱 - 磁盘分析、临时文件清理、IIS 站点管理、批量文件操作、服务状态监控、Windows Update 诊断、实时性能监控、安全审计、注册表启动项审计、磁盘健康检测、网络端口监控、事件日志诊断、已安装程序管理、用户会话监控、计划任务审计、文件共享审计、DNS网卡诊断、SSL证书过期检测、防火墙规则审计、服务崩溃恢复状态、系统文件修复、存储池管理、备份状态检查、Docker容器管理、K8s集群监控。只读分析+安全确认,绝不误删文件,完全免费离线运行。

下载
RemoveDirectory

、

FindFirstFile

,或者POSIX系统(Linux/macOS)上的

mkdir

、

rmdir

、

opendir

、

readdir

。这种分裂导致了大量的条件编译代码,为了实现一个简单的跨平台文件管理功能,你可能需要写两套甚至三套不同的实现,这无疑增加了代码的复杂性和维护成本。

std::filesystem

的出现彻底改变了这一局面。它提供了一个统一的、抽象的接口,将底层操作系统的差异封装起来。这意味着你写一次代码,就可以在Windows、Linux、macOS等不同平台上无缝运行,而无需关心具体的系统调用细节。这不仅仅是方便,它还极大地提升了代码的可移植性和可读性。此外,

std::filesystem

还引入了

std::filesystem::path

这个核心概念,它以一种类型安全的方式处理路径,自动处理斜杠方向、路径拼接等常见问题,避免了字符串操作可能带来的错误和不一致性。它还内置了异常处理机制,让错误管理变得更加健壮。从个人经验来看,从Boost.Filesystem(

<filesystem></filesystem>

的前身)到标准库的演进,这种统一和现代化的趋势,让C++在系统编程领域的能力又提升了一个台阶,真正让开发者能更专注于业务逻辑而非底层适配。

在实际项目中,处理目录操作的常见陷阱和最佳实践是什么?

目录操作看似简单,但在实际项目中却充满了各种微妙的陷阱,如果不小心,可能会导致程序崩溃、数据丢失甚至安全漏洞。

常见陷阱:

  1. 权限问题: 这是最常见的,尝试在没有写入权限的路径创建目录,或删除没有删除权限的目录,都会导致操作失败。程序需要优雅地处理这些错误,而不是直接崩溃。
  2. 路径解析与标准化: 相对路径、绝对路径、斜杠方向(
    /
    vs
    \
    ),以及路径中可能存在的
    ..
    或
    .
    等特殊字符,都可能导致意外的行为。尤其是在拼接路径时,手动字符串拼接很容易出错。
  3. 非空目录的删除: 许多系统API(如POSIX的
    rmdir
    )只能删除空目录。如果尝试删除非空目录,会失败。
    std::filesystem::remove_all
    解决了这个问题,但其破坏性也意味着需要更谨慎的使用。
  4. 竞态条件: 在多线程或多进程环境中,一个进程创建了目录,另一个进程同时尝试删除它,或者在检查目录是否存在后,目录状态在实际操作前发生了改变,都可能引发问题。
  5. 字符编码: 在Windows上,文件名通常使用宽字符(UTF-16),而在Linux上通常是UTF-8。如果直接使用窄字符串处理路径,可能会遇到乱码或找不到路径的问题。
    std::filesystem::path
    在内部会处理这些,但如果需要与旧API交互,仍需注意。
  6. 符号链接(Symbolic Links): 遍历目录时,遇到符号链接需要决定是跟随链接进入其目标目录,还是将其作为文件本身处理。不当处理可能导致无限循环或意外的数据删除。

最佳实践:

  1. 始终检查操作结果或捕获异常:
    std::filesystem
    的函数通常会抛出
    std::filesystem::filesystem_error
    异常,或者提供一个接受
    std::error_code
    参数的重载版本。务必处理这些错误,提供有意义的错误信息。
  2. 使用
    std::filesystem::path
    进行所有路径操作:
    避免手动拼接字符串来构建路径。
    std::filesystem::path
    提供了重载的
    /
    运算符,可以安全、跨平台地拼接路径。它还能处理路径的规范化。
  3. 理解
    remove
    与
    remove_all
    的区别:
    对于删除操作,明确知道是要删除空目录/文件,还是连同其内容一并删除。
    remove_all
    在生产环境中,特别是用户输入路径时,应极为谨慎,最好有二次确认机制。
  4. 明确指定递归行为: 遍历时,根据需求选择
    directory_iterator
    (非递归)或
    recursive_directory_iterator
    (递归)。对于
    copy
    操作,
    copy_options
    也能控制递归行为。
  5. 处理符号链接: 在遍历时,使用
    entry.is_symlink()
    来判断是否是符号链接,并根据业务逻辑决定是否调用
    std::filesystem::read_symlink
    来获取其目标路径,或者使用
    std::filesystem::symlink_status
    来获取链接本身的属性。
  6. 日志记录: 记录所有文件系统操作的成功与失败,以及详细的错误信息,这对于调试和系统审计至关重要。
  7. 原子性操作的考虑: 对于关键的目录操作(如创建临时目录、移动文件),如果需要保证操作的原子性(要么全部成功,要么全部失败),可能需要结合操作系统提供的事务性文件系统功能(如果可用)或者自定义的重试/回滚逻辑。

除了基础操作,C++文件系统库还能实现哪些高级功能?

std::filesystem

库远不止于简单的创建、删除和遍历。它提供了一整套丰富的功能,使得文件系统管理变得非常强大和灵活。

  1. 路径查询与信息获取:

    • std::filesystem::exists(p)
      : 检查路径
      p
      是否存在。
    • std::filesystem::is_directory(p)
      : 判断
      p
      是否是目录。
    • std::filesystem::is_regular_file(p)
      : 判断
      p
      是否是普通文件。
    • std::filesystem::is_symlink(p)
      : 判断
      p
      是否是符号链接。
    • std::filesystem::file_size(p)
      : 获取文件大小(字节)。
    • std::filesystem::last_write_time(p)
      : 获取文件的最后写入时间。
    • std::filesystem::status(p)
      和
      std::filesystem::symlink_status(p)
      : 获取文件或符号链接的详细状态信息,包括文件类型、权限等。
  2. 路径操作与转换:

    • std::filesystem::absolute(p)
      : 获取路径
      p
      的绝对路径。
    • std::filesystem::canonical(p)
      : 获取路径
      p
      的规范路径(解析所有
      ..
      、
      .
      和符号链接)。
    • std::filesystem::relative(p, base)
      : 获取
      p
      相对于
      base
      的相对路径。
    • std::filesystem::current_path()
      /
      std::filesystem::current_path(p)
      : 获取或设置当前工作目录。
    • path::filename()
      ,
      path::stem()
      ,
      path::extension()
      : 从路径中提取文件名、不带扩展名的文件名和扩展名。
    • path::parent_path()
      : 获取父目录路径。
  3. 文件和目录的复制与移动:

    • std::filesystem::copy(from, to, options)
      : 复制文件或目录。
      options
      参数非常强大,可以控制复制行为,比如是否递归复制、是否覆盖现有文件、是否跟随符号链接等。
    • std::filesystem::copy_file(from, to, options)
      : 专门用于复制文件,提供更细粒度的控制。
    • std::filesystem::rename(old_path, new_path)
      : 重命名或移动文件/目录。
  4. 权限管理:

    • std::filesystem::permissions(p, prms, options)
      : 修改文件或目录的权限。
      prms
      是一个位掩码,表示要设置的权限(如读、写、执行),
      options
      可以指定如何应用这些权限(添加、移除、设置)。
  5. 临时文件和目录:

    • std::filesystem::temp_directory_path()
      : 获取系统推荐的临时目录路径。虽然库本身没有直接提供创建唯一临时文件/目录的函数,但结合
      path::unique()
      和
      create_directory
      可以实现。

这些高级功能使得

std::filesystem

不仅仅是一个简单的文件操作工具,它更像是一个完整的、现代化的文件系统管理框架,能够支持从简单的文件操作到复杂的目录同步、文件系统遍历和清理等各种场景。例如,你可以利用

recursive_directory_iterator

结合

file_size

来计算一个目录的总大小,或者结合

last_write_time

来找出最近修改的文件。通过灵活运用这些功能,可以构建出强大且跨平台的文件系统应用程序。

C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

2023.10.24

6444

49

Go语言中的运算符有哪些
Go语言中的运算符有哪些

Go语言中的运算符有:1、加法运算符;2、减法运算符;3、乘法运算符;4、除法运算符;5、取余运算符;6、比较运算符;7、位运算符;8、按位与运算符;9、按位或运算符;10、按位异或运算符等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

3624

5

php三元运算符用法
php三元运算符用法

本专题整合了php三元运算符相关教程,阅读专题下面的文章了解更多详细内容。

2025.10.17

1972

13

go语言 面向对象
go语言 面向对象

本专题整合了go语言面向对象相关内容,阅读专题下面的文章了解更多详细内容。

2025.09.05

8035

14

java面向对象
java面向对象

本专题整合了java面向对象相关内容,阅读专题下面的文章了解更多详细内容。

2025.11.27

382

13

C++ 面向对象编程与设计模式实践
C++ 面向对象编程与设计模式实践

本专题整合了 C++ 面向对象编程的核心机制,涵盖类的定义与访问控制、构造函数与析构函数、拷贝语义与移动语义、继承与虚函数多态、抽象类与接口、运算符重载、友元函数等关键知识点,同时结合单例模式、工厂模式、观察者模式、策略模式等常用设计模式的 C++ 实现,帮助开发者写出结构清晰、易于维护的面向对象代码。

2026.04.09

384

30

Java 面向对象与核心编程机制
Java 面向对象与核心编程机制

系统讲解 Java 面向对象编程的核心知识体系,涵盖类的定义与封装、构造方法与 this/super 关键字、继承与方法重写、多态与向上向下转型、抽象类与接口的区别与设计原则、异常处理机制(try-catch-finally / 自定义异常)、泛型的类型参数与通配符、集合框架(List/Set/Map)的使用与遍历方式,帮助开发者全面掌握 Java 程序设计的核心机制与面向对象思维。

2026.04.17

263

15

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1958

5

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

3284

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习