文件描述符与FILE互转：fileno、fdopen

说到文件操作，C语言给了我们两套工具：一套是高级的FILE流，一套是低级的文件描述符。很多初学者会问，我到底该用哪个？我的答案是——两个都用。

嗯，你没听错。在实际项目中，我们经常需要在两者之间来回切换。比如你用fopen打开文件，但某个底层接口偏偏只认文件描述符；或者你拿到了一个socket描述符，却想用fprintf来格式化输出。这时候，fileno和fdopen就是你的桥梁。

为什么需要两套接口？

先理清一个概念。FILE流是带缓冲的，文件描述符是不带缓冲的。高级IO（fread、fwrite、fprintf）帮你管理缓冲区，低级IO（read、write）直接跟内核打交道。

我个人习惯是：读写文本数据用FILE流，处理二进制数据或需要精细控制时用文件描述符。但现实往往没那么理想——你可能会拿到一个FILE*，却需要传给一个只接受int fd的函数。或者反过来。

核心原则：同一个文件，不要同时用两套接口操作。要么全用FILE流，要么全用文件描述符。混用会导致缓冲区数据不一致，你想想看，fwrite写了一半的数据还在缓冲区里，你直接write去写，顺序就乱了。

fileno：从FILE*拿到文件描述符

fileno的作用很简单：给定一个FILE指针，返回它背后对应的文件描述符。

#include <stdio.h>

int fileno(FILE *stream);

返回值是int类型的文件描述符。如果失败，返回-1并设置errno。

我在项目中遇到过这样一个场景：我们需要用fcntl给某个文件设置非阻塞标志，但代码里用的全是FILE流。这时候直接调用fileno(fp)拿到描述符，再传给fcntl就行了。

FILE *fp = fopen("data.txt", "r");
if (!fp) {
    perror("fopen");
    return -1;
}

int fd = fileno(fp);
if (fd == -1) {
    perror("fileno");
    fclose(fp);
    return -1;
}

// 设置非阻塞
int flags = fcntl(fd, F_GETFL);
fcntl(fd, F_SETFL, flags | O_NONBLOCK);

// 继续用fread/fwrite操作
char buf[128];
size_t n = fread(buf, 1, sizeof(buf), fp);

小提示：fileno不会关闭或复制文件描述符，它只是把内部的值告诉你。所以不要对返回的fd调用close——除非你不再需要FILE流了，而且你清楚自己在做什么。

fdopen：从文件描述符创建FILE流

fdopen是反向操作：给你一个文件描述符，包装成一个FILE指针。

#include <stdio.h>

FILE *fdopen(int fd, const char *mode);

mode参数跟fopen一样，比如"r"、"w"、"a"等。但要注意，mode必须和fd原本的打开模式兼容。你拿一个只读的描述符去用"w"模式，那肯定报错。

我曾经接手过一个网络服务程序，底层用socket描述符收发数据，但上层业务逻辑全是fprintf、fscanf那一套。改造方案很简单：用fdopen把socket描述符包装成FILE流，上层代码几乎不用改。

int sockfd = socket(AF_INET, SOCK_STREAM, 0);
// ... connect 等操作 ...

// 包装成FILE流
FILE *fp = fdopen(sockfd, "r+");
if (!fp) {
    perror("fdopen");
    close(sockfd);
    return -1;
}

// 现在可以愉快地用fprintf了
fprintf(fp, "GET /index.html HTTP/1.1\r\n");
fprintf(fp, "Host: example.com\r\n");
fprintf(fp, "\r\n");
fflush(fp);  // 别忘了刷新！

// 读取响应
char buf[4096];
while (fgets(buf, sizeof(buf), fp)) {
    printf("收到: %s", buf);
}

注意：fdopen创建FILE流后，文件描述符归FILE流管理。关闭FILE流时（fclose），底层的文件描述符也会被关闭。如果你不想关闭描述符，可以用dup复制一份再传给fdopen。

混合使用的正确姿势

说白了，混用高级和低级IO的关键就一条：注意缓冲区。

FILE流有用户态缓冲区，文件描述符没有。当你从FILE流切换到文件描述符时，缓冲区里可能还有没写完的数据。反过来也一样，文件描述符写完了，FILE流不知道，它的缓冲区状态是过时的。

我建议的做法是：

  1. 确定主接口：选一个作为主要操作方式，另一个只做临时转换。
  2. 及时刷新：在切换之前，调用fflush清空FILE流的缓冲区。
  3. 不要混用读写：同一个文件，要么全用FILE流读写，要么全用文件描述符。别今天fread明天read。
// 正确示例：先刷新，再切换
FILE *fp = fopen("log.txt", "w");
fprintf(fp, "这是一条日志\n");
fflush(fp);  // 确保数据写入内核缓冲区

int fd = fileno(fp);
// 现在可以安全地用write了
write(fd, "直接写入\n", 10);

fclose(fp);  // 关闭FILE流，同时关闭fd

一张图理清关系

下面这张图展示了FILE流、文件描述符和内核文件表之间的关系：

文件描述符与FILE流的关系 用户空间 FILE *fp 带缓冲的流接口 int fd 无缓冲的整数句柄 fileno() fdopen() 内核空间 文件表项 (文件偏移、状态标志) v节点 / i节点 (磁盘文件信息) 指向 FILE流内部包含文件描述符，文件描述符指向内核文件表项

实际项目中的选择策略

我总结了一个简单的决策表，帮你快速判断该用哪套接口：

场景 推荐接口 原因
读写文本文件 FILE流 fprintf/fscanf方便，自动缓冲性能好
网络socket通信 文件描述符 需要精细控制，避免缓冲带来的延迟
需要fcntl/ioctl 文件描述符 这些接口只认int fd
格式化输出到socket FILE流（fdopen包装） fprintf写协议头很方便，记得fflush
大文件顺序读写 FILE流 缓冲机制减少系统调用次数
需要非阻塞IO 文件描述符 FILE流不支持非阻塞模式

我的经验：如果你不确定该用哪个，先用FILE流。大多数场景下它够用，而且出错概率低。等遇到性能瓶颈或特殊需求时，再考虑切换到文件描述符。别一开始就追求"底层控制"，那往往是过度设计。

避坑指南

我曾经在一个日志系统里犯过这样的错误：先用fwrite写了一批日志，然后直接拿fileno返回的fd去调用write，结果日志顺序全乱了。原因就是fwrite的数据还在缓冲区里没刷出去，write的数据反而先落盘了。

所以记住：

  • 切换前一定fflush，这是铁律。
  • 不要对同一个文件同时持有FILE*和fd，除非你只用其中一个操作。
  • fclose会关闭底层的fd，如果你不想关闭，用dup复制一份。
  • fdopen不会改变fd的打开模式，mode参数只是做兼容性检查。

嗯，掌握了这些，你就能在高级和低级IO之间自由切换了。说白了，fileno和fdopen就是两座桥，让你在需要的时候随时过河。用好了，代码既灵活又高效。

公众号:蓝海资料掘金营，微信deep3321

← 上一章 📖 返回目录 下一章 →