Creamy络1. Linux C 文件操作核心结构体概述
在Linux系统编程中，文件操作是最基础也是最重要的功能之一。作为一位从事嵌入式开发多年的工程师，我深刻体会到熟练掌握这些文件操作结构体的重要性。无论是开发文件系统、日志模块，还是实现配置管理，都离不开对文件的高效操作。
Linux系统提供了丰富的文件操作接口，从标准C库到系统调用，形成了多层次的抽象。其中，dirent、stat、DIR、FILE和glob_t这五个结构体构成了Linux C文件操作的核心框架。它们各自承担着不同的职责，但又相互关联，共同完成了从目录遍历到文件读写的完整功能链。
在实际项目中，我见过太多因为对这些结构体理解不透彻而导致的bug：有的程序遍历目录时遗漏文件，有的无法正确处理特殊文件类型，还有的因为资源泄漏导致系统性能下降。这些问题往往在测试阶段难以发现，但在生产环境中却可能造成严重后果。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. struct dirent：目录项结构解析
2.1 基本定义与用途
struct dirent定义在<dirent.h>头文件中，它是目录操作的基础数据结构。每当我们调用readdir()函数读取目录内容时，返回的就是这个结构体的指针。它包含了目录中一个文件项的基本信息，是目录遍历的核心。
这个结构体在不同系统上可能有细微差别，但都至少包含以下关键字段：
- d_ino：文件的inode编号，这是文件在文件系统中的唯一标识
- d_name：文件名，以null结尾的字符数组
- d_type（非POSIX标准）：文件类型，如普通文件、目录等
2.2 实际应用示例
下面是一个更完整的目录遍历示例，展示了如何处理各种文件类型：
c复制#include <dirent.h>
#include <stdio.h>
#include <string.h>
#include <errno.h>
void list_directory(const char *path) {
DIR *dir = opendir(path);
if (!dir) {
fprintf(stderr, "无法打开目录 %s: %s\n", path, strerror(errno));
return;
}
struct dirent *entry;
while ((entry = readdir(dir)) != NULL) {
// 跳过当前目录和上级目录
if (strcmp(entry->d_name, ".") == 0 || strcmp(entry->d_name, "..") == 0)
continue;
// 打印文件信息
printf("%8lu %s", (unsigned long)entry->d_ino, entry->d_name);
// 如果支持d_type，显示文件类型
#ifdef _DIRENT_HAVE_D_TYPE
switch (entry->d_type) {
case DT_REG: printf(" (普通文件)"); break;
case DT_DIR: printf(" (目录)"); break;
case DT_LNK: printf(" (符号链接)"); break;
// 其他类型处理...
}
#endif
printf("\n");
}
if (closedir(dir) == -1) {
fprintf(stderr, "关闭目录失败: %s\n", strerror(errno));
}
}
2.3 注意事项与常见问题
-
线程安全问题：readdir()函数在多线程环境下不是线程安全的。如果需要在多线程程序中遍历目录，应该使用readdir_r()（已废弃）或考虑使用互斥锁保护。
-
缓冲区重用：readdir()返回的指针指向一个内部缓冲区，每次调用都会覆盖之前的内容。如果需要保存文件名，应该立即复制d_name字段的内容。
-
文件类型判断：虽然d_type字段很方便，但它不是POSIX标准的一部分。更可靠的方式是使用stat()函数获取完整的文件信息。
-
错误处理：opendir()可能因为权限不足、路径不存在等原因失败，必须检查返回值并适当处理错误。
3. struct stat：文件属性深度解析
3.1 结构体详解
struct stat是获取文件元信息的核心结构体，定义在<sys/stat.h>中。它包含了文件的几乎所有属性信息，主要字段包括：
- st_mode：文件类型和权限位
- st_ino：inode编号
- st_size：文件大小（字节）
- st_atime/st_mtime/st_ctime：访问/修改/状态变更时间
- st_uid/st_gid：所有者和组ID
- st_blksize/st_blocks：块大小和分配的块数
3.2 文件类型判断技巧
st_mode字段包含了丰富的文件类型信息，通过以下宏可以判断文件类型：
c复制S_ISREG(m) // 普通文件
S_ISDIR(m) // 目录
S_ISCHR(m) // 字符设备
S_ISBLK(m) // 块设备
S_ISFIFO(m) // FIFO/命名