C / C++ / 系统课时

用 opendir 遍历目录内容

用 opendir 遍历目录内容

遍历 Linux 目录时,不能把目录当普通文本文件读取,而要通过目录流逐项取得目录项。本篇用 opendir、readdir 和 closedir 写完整程序,并用 fstatat 可靠区分普通文件、子目录和符号链接。

学习目标

  • 理解 opendir、readdir、closedir 在目录遍历中的职责
  • 能写出包含结束判断、错误处理和资源释放的遍历循环
  • 能在 d_type 不可靠时使用文件状态接口判断目录项类型

三个目录流接口怎样配合

opendir(path) 打开目录并返回 DIR *;之后反复调用 readdir(dir),每次取得一个 struct dirent *。当 readdir 返回 NULL 时,既可能表示已经遍历结束,也可能表示发生错误,因此需要结合 errno 判断。最后无论是否找到目标,都应调用 closedir(dir) 释放目录流。

opendir、readdir 与 closedir 的遍历流程

目录通常还包含 . 和 ..,分别代表当前目录和父目录。多数遍历任务会主动跳过它们,避免把这两个特殊项当作普通业务文件处理。

可运行的目录遍历程序

下面程序默认遍历当前目录,也可以把目标目录作为第一个命令行参数。它不直接依赖 dirent.d_type,而是基于已经打开的目录描述符调用 fstatat,因此在更多文件系统上都能得到可靠类型。

c
#define _POSIX_C_SOURCE 200809L

#include <dirent.h>
#include <errno.h>
#include <fcntl.h>
#include <stdio.h>
#include <string.h>
#include <sys/stat.h>

static const char *type_name(mode_t mode) {
    if (S_ISREG(mode)) {
        return "regular";
    }
    if (S_ISDIR(mode)) {
        return "directory";
    }
    if (S_ISLNK(mode)) {
        return "symlink";
    }
    return "other";
}

int main(int argc, char *argv[]) {
    const char *path = argc > 1 ? argv[1] : ".";
    DIR *dir = opendir(path);
    if (dir == NULL) {
        perror("opendir");
        return 1;
    }

    int dfd = dirfd(dir);
    if (dfd == -1) {
        perror("dirfd");
        closedir(dir);
        return 1;
    }

    for (;;) {
        errno = 0;
        struct dirent *entry = readdir(dir);

        if (entry == NULL) {
            if (errno != 0) {
                perror("readdir");
                closedir(dir);
                return 1;
            }
            break;
        }

        if (strcmp(entry->d_name, ".") == 0 ||
            strcmp(entry->d_name, "..") == 0) {
            continue;
        }

        struct stat st;
        if (fstatat(dfd, entry->d_name, &st, AT_SYMLINK_NOFOLLOW) == -1) {
            fprintf(stderr, "fstatat %s: %s\n",
                    entry->d_name, strerror(errno));
            continue;
        }

        printf("%-10s %s\n", type_name(st.st_mode), entry->d_name);
    }

    if (closedir(dir) == -1) {
        perror("closedir");
        return 1;
    }

    return 0;
}

预期结果

text
程序成功编译后,每个非 . 和 .. 的目录项输出一行“类型 名称”;具体行由目标目录内容决定。

为了得到可核对的结果,可以先准备一个只包含一个子目录和一个普通文件的测试目录,再编译运行。假设源码保存为 dirwalk.c:

bash
cc -std=c11 -Wall -Wextra -pedantic dirwalk.c -o dirwalk
rm -rf /tmp/anystack-dir-demo
mkdir -p /tmp/anystack-dir-demo/subdir
printf 'hello\n' > /tmp/anystack-dir-demo/note.txt
./dirwalk /tmp/anystack-dir-demo | sort

预期输出

text
directory  subdir
regular    note.txt

这里通过 sort 固定展示顺序;如果直接运行程序,readdir 返回目录项的先后顺序不应被业务逻辑依赖。

为什么不能只相信 d_type

struct dirent 在 Linux 上通常包含 d_type,常见值有 DT_REG 和 DT_DIR。但 POSIX 并不要求所有文件系统都填充它,某些情况下会得到 DT_UNKNOWN。如果程序必须正确识别类型,就应再调用 stat、lstat 或 fstatat。

示例使用 fstatat(dfd, name, ..., AT_SYMLINK_NOFOLLOW):dfd 来自 dirfd(dir),因此不必手工拼接完整路径;AT_SYMLINK_NOFOLLOW 让符号链接按“链接本身”分类,而不是跟随到它指向的目标。

正确区分结束、错误与资源释放

readdir 返回 NULL 前先把 errno 设为 0,是为了区分两种情况:返回后 errno 仍为 0 表示正常到达目录末尾,非 0 才表示读取失败。不要仅凭 NULL 就打印错误。

目录流同样是一种需要释放的资源。正常遍历结束后要调用 closedir;如果中途遇到必须退出的错误,也要在返回前关闭目录流。若只是某个目录项的 fstatat 失败,可以记录错误并继续处理后面的条目,这通常比直接放弃整个目录更实用。

当需求只是收集名称时,readdir 已经足够;当需求还包含“这是普通文件还是子目录”“是否为符号链接”等判断时,再补充状态查询接口,能让遍历逻辑在不同文件系统上保持一致。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 opendir 遍历目录内容

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通