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) 释放目录流。

目录通常还包含 . 和 ..,分别代表当前目录和父目录。多数遍历任务会主动跳过它们,避免把这两个特殊项当作普通业务文件处理。
可运行的目录遍历程序
下面程序默认遍历当前目录,也可以把目标目录作为第一个命令行参数。它不直接依赖 dirent.d_type,而是基于已经打开的目录描述符调用 fstatat,因此在更多文件系统上都能得到可靠类型。
#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;
}预期结果
程序成功编译后,每个非 . 和 .. 的目录项输出一行“类型 名称”;具体行由目标目录内容决定。为了得到可核对的结果,可以先准备一个只包含一个子目录和一个普通文件的测试目录,再编译运行。假设源码保存为 dirwalk.c:
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预期输出
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 已经足够;当需求还包含“这是普通文件还是子目录”“是否为符号链接”等判断时,再补充状态查询接口,能让遍历逻辑在不同文件系统上保持一致。