C++实现文件目录树（手把手教你用C++递归遍历并可视化本地文件系统）

为什么需要目录树？

目录树是一种树形结构，用于展示文件夹及其子文件夹和文件的层级关系。通过 目录结构可视化C++，我们可以清晰地看到项目的组织方式，这在调试、部署或分享代码时非常有用。

准备工作：C++17 的 filesystem 库

从 C++17 开始，标准库引入了 <filesystem> 头文件，它提供了跨平台的文件系统操作功能。我们将使用其中的 std::filesystem::directory_iterator 和 std::filesystem::recursive_directory_iterator 来遍历目录。

确保你的编译器支持 C++17（如 GCC 9+、Clang 9+、MSVC 2019+），并在编译时添加 -std=c++17 参数。

实现思路

我们将采用 C++递归遍历目录 的方式：

• 从根目录开始
• 对每个子项判断是文件还是目录
• 如果是目录，则递归进入；否则直接打印
• 使用缩进表示层级深度

完整代码实现

下面是一个完整的 C++ 程序，用于打印指定路径的目录树：

#include <iostream>#include <filesystem>#include <string>namespace fs = std::filesystem;void printDirectoryTree(const fs::path& path, int depth = 0) {    // 打印当前文件/目录名    std::string indent(depth * 2, ' '); // 每层缩进两个空格        if (fs::is_directory(path)) {        std::cout << indent << "📁 " << path.filename().string() << "/\n";                // 递归遍历子目录        try {            for (const auto& entry : fs::directory_iterator(path)) {                printDirectoryTree(entry.path(), depth + 1);            }        } catch (const fs::filesystem_error& e) {            std::cerr << indent << "⚠️ 无法访问: " << e.what() << "\n";        }    } else {        std::cout << indent << "📄 " << path.filename().string() << "\n";    }}int main() {    std::string inputPath;    std::cout << "请输入要遍历的目录路径: ";    std::getline(std::cin, inputPath);        fs::path rootPath(inputPath);        if (!fs::exists(rootPath)) {        std::cerr << "错误：路径不存在！\n";        return 1;    }        std::cout << "\n--- 目录树结构 ---\n";    printDirectoryTree(rootPath);        return 0;}

代码详解

1. 命名空间简化：使用 namespace fs = std::filesystem; 避免重复输入长名字。
2. 递归函数：printDirectoryTree 接收路径和当前深度，根据是否为目录决定是否继续递归。
3. 异常处理：某些目录可能因权限问题无法访问，使用 try-catch 捕获 filesystem_error 并提示用户。
4. 图标美化：使用 📁 表示文件夹，📄 表示文件，提升可读性（终端需支持 Unicode）。

编译与运行

保存代码为 dir_tree.cpp，然后在终端执行：

g++ -std=c++17 -o dir_tree dir_tree.cpp./dir_tree

程序会提示你输入路径，例如输入 . 表示当前目录。

扩展建议

掌握了基础的 文件系统操作C++ 后，你可以尝试以下增强功能：

• 按文件类型过滤（如只显示 .cpp 文件）
• 统计文件总数和目录总数
• 输出为 JSON 或 HTML 格式
• 添加图形界面（使用 Qt 或其他 GUI 库）

总结

通过本文，你学会了如何使用 C++17 的 <filesystem> 库实现一个实用的 C++文件目录树 工具。这不仅加深了你对 C++递归遍历目录 的理解，也为后续开发打下了坚实基础。快去试试吧！