如何用 opendir 实现递归遍历

开门见山，很多朋友在C语言里处理文件系统时，都会遇到一个经典需求：递归遍历目录。你可能会想，直接用 opendir 不就行了吗？其实不然。opendir 这个函数本身，只负责为你打开一个目录流，让你能读取里面的条目。它可没有“递归”这个本事。要想实现深度遍历，你得自己动手，把 opendir、readdir 和 closedir 这几个兄弟组合起来用，并且在遇到子目录时，巧妙地让程序自己调用自己——也就是递归。

光说不练假把式，下面就是一个典型的C语言实现，你可以把它看作一个清晰的模板。

#include 
#include 
#include 
#include 
#include 

void list_directory_contents(const char *path) {
    DIR *dir;
    struct dirent *entry;
    struct stat path_stat;

    dir = opendir(path);
    if (dir == NULL) {
        perror("opendir");
        return;
    }

    while ((entry = readdir(dir)) != NULL) {
        if (strcmp(entry->d_name, ".") == 0 || strcmp(entry->d_name, "..") == 0) {
            continue;
        }

        // 构建完整的路径
        char full_path[PATH_MAX];
        snprintf(full_path, sizeof(full_path), "%s/%s", path, entry->d_name);

        // 获取文件/目录的详细信息
        if (stat(full_path, &path_stat) == -1) {
            perror("stat");
            continue;
        }

        // 如果是目录，递归调用
        if (S_ISDIR(path_stat.st_mode)) {
            list_directory_contents(full_path);
        } else {
            // 如果是文件，打印文件名
            printf("%s\n", full_path);
        }
    }
    closedir(dir);
}

int main(int argc, char *argv[]) {
    if (argc != 2) {
        fprintf(stderr, "Usage: %s \n", argv[0]);
        return EXIT_FAILURE;
    }
    list_directory_contents(argv[1]);
    return EXIT_SUCCESS;
}

代码说明：

这段代码的逻辑其实非常清晰，我们拆开来看：

1. list_directory_contents 函数（核心递归引擎）：

   • 首先，它尝试用 opendir 打开你给的路径。
   • 接着，进入一个循环，用 readdir 逐个读取目录里的所有条目。
   • 这里有个关键细节：必须跳过代表当前目录的 . 和上级目录的 ..，否则程序会陷入无限循环。
   • 然后，为每个条目拼接出完整的绝对路径，这是后续操作的基础。
   • 调用 stat 函数来获取这个路径的详细信息，判断它到底是文件还是目录。
   • 精髓就在这里：如果判断结果是目录，函数就直接调用它自己（递归），传入这个子目录的路径。如果不是目录，那就是文件，直接打印路径即可。
   • 最后，别忘了用 closedir 关闭打开的目录流，释放资源。

2. main 函数（程序入口）：

   • 它的任务很简单：检查用户是否通过命令行参数正确提供了一个目录路径。
   • 验证通过后，就调用上面的递归函数，开始整个遍历之旅。

编译和运行：

实际动手试试，印象才深刻。你可以这样操作：

gcc -o listdir listdir.c
./listdir /path/to/directory

运行之后，这个程序就会像一只勤快的小蜜蜂，从你指定的目录出发，钻进每一个子文件夹，并把所有找到的文件的完整路径，一一呈现在你面前。