9、文件I/O与编码：fopen/fread/fwrite的跨平台行为、文本模式与二进制模式（b标志）

文件操作，是C语言里最基础也最容易踩坑的地方。很多新手觉得fopen、fread、fwrite不就是打开、读写、关闭三板斧吗？嗯，表面上看确实如此。但一旦你开始做跨平台开发，Windows和Linux之间的差异会让你头疼不已。我当年第一次把Linux下的程序移植到Windows上，结果读出来的二进制文件全是乱码，排查了半天才发现是文本模式和二进制模式的问题。

说白了，文件I/O的跨平台问题，核心就两点：换行符的差异和文本/二进制模式的选择。今天我们就来彻底讲清楚。

9.1 文本模式 vs 二进制模式：到底差在哪？

fopen函数的第二个参数，大家都很熟悉：

FILE *fp = fopen("test.txt", "r");   // 文本模式读
FILE *fp = fopen("test.bin", "rb");  // 二进制模式读
FILE *fp = fopen("output.txt", "w");  // 文本模式写
FILE *fp = fopen("output.bin", "wb"); // 二进制模式写

关键就在这个"b"标志上。有b就是二进制模式，没有b就是文本模式。那它们到底有什么区别？

核心区别：换行符的自动转换

在Windows系统上，文本文件中的换行是"\r\n"（回车+换行，0x0D 0x0A）。但在C语言内部，我们习惯用'\n'来表示换行。所以Windows的C运行时库在文本模式下，会自动做转换：

• 读操作：文件中的"\r\n"被转换为'\n'
• 写操作：程序中的'\n'被转换为"\r\n"写入文件

而在Linux/macOS上，换行符就是'\n'，不存在这个转换问题。所以Linux下文本模式和二进制模式的行为完全一样。

9.2 我踩过的坑：一个真实的案例

我记得有一次，我需要写一个工具，读取一个PNG图片文件，修改几个字节后再写回去。在Linux上跑得好好的，拿到Windows上一跑，图片全花了。

排查过程是这样的：

1. 先对比原始文件和输出文件的字节数——发现输出文件比原始文件大了几十个字节
2. 用十六进制编辑器打开一看，所有0x0A前面都多了一个0x0D
3. 再一看代码，fopen用的是"w"而不是"wb"

嗯，问题找到了。Windows把'\n'自动扩展成了"\r\n"，二进制文件就这么被毁了。从那以后，我养成了一个习惯：只要不是纯文本文件，一律用二进制模式。

9.3 fread和fwrite的跨平台行为

fread和fwrite本身是跨平台的，它们的原型是：

size_t fread(void *ptr, size_t size, size_t nmemb, FILE *stream);
size_t fwrite(const void *ptr, size_t size, size_t nmemb, FILE *stream);

这两个函数的行为在Windows和Linux上完全一致——它们按字节块读写，不关心内容。但要注意：fread/fwrite的行为受fopen模式的影响。

举个例子：

// 文本模式读
FILE *fp = fopen("data.txt", "r");
char buf[1024];
size_t n = fread(buf, 1, 1024, fp);
// 在Windows上，buf中的'\r'已经被去掉了

// 二进制模式读
FILE *fp = fopen("data.bin", "rb");
char buf[1024];
size_t n = fread(buf, 1, 1024, fp);
// 原样读取，不做任何转换

9.4 跨平台文件I/O的最佳实践

我个人总结了几个原则，分享给大家：

• 原则一：二进制文件永远用"b"标志。图片、音频、视频、压缩包、可执行文件，统统用"rb"或"wb"。
• 原则二：文本文件在Windows上建议也用"b"标志。为什么？因为你可以自己控制换行符的处理，避免平台差异。很多跨平台项目（比如Git）都推荐这么做。
• 原则三：如果必须用文本模式，记得用fgets/fputs而不是fread/fwrite。fgets/fputs天然处理换行符，更安全。

我曾经参与过一个项目，代码里大量使用了fread/fwrite来读写配置文件（JSON格式）。在Windows上测试时，配置文件总是解析失败。后来发现，问题出在fread读取时，文本模式把"\r\n"变成了'\n'，导致JSON解析器在计算字节偏移时出错。解决方案很简单：把fopen的"r"改成"rb"，然后自己处理换行符。

9.5 文件编码问题：一个容易被忽略的点

说到文件I/O，就不得不提编码。C语言的标准文件I/O函数是不关心编码的——它们只处理字节流。但实际项目中，我们经常需要处理UTF-8、GBK等编码的文本文件。

这里有个常见的误解：很多人以为fread/fwrite能处理编码。其实不能。它们只是把字节从文件搬到内存，或者从内存搬到文件。编码转换需要你自己做。

举个例子：

// 读取一个UTF-8编码的文本文件
FILE *fp = fopen("utf8.txt", "rb");  // 用二进制模式
char buf[4096];
size_t n = fread(buf, 1, 4096, fp);
buf[n] = '\0';
// 此时buf里是UTF-8编码的字节序列
// 如果你需要GBK编码，需要调用编码转换库（如iconv）

9.6 知识体系图：文件I/O跨平台核心逻辑

下面这张图总结了文件I/O跨平台开发的核心逻辑，我建议你保存下来，写代码时对照着看：

9.7 实战：跨平台文件读写模板

最后，我给出一个我自己常用的跨平台文件读写模板。这个模板在Windows和Linux上都能正常工作：

#include <stdio.h>
#include <stdlib.h>
#include <string.h>

// 跨平台安全的文件读取函数
// 始终使用二进制模式，避免换行符转换问题
char* read_file_safe(const char* filename, size_t* out_size) {
    FILE* fp = fopen(filename, "rb");
    if (!fp) return NULL;
    
    // 获取文件大小
    fseek(fp, 0, SEEK_END);
    long size = ftell(fp);
    fseek(fp, 0, SEEK_SET);
    
    if (size <= 0) {
        fclose(fp);
        return NULL;
    }
    
    // 分配内存并读取
    char* buf = (char*)malloc(size + 1);
    if (!buf) {
        fclose(fp);
        return NULL;
    }
    
    size_t n = fread(buf, 1, size, fp);
    fclose(fp);
    
    buf[n] = '\0';
    if (out_size) *out_size = n;
    
    return buf;
}

// 跨平台安全的文件写入函数
int write_file_safe(const char* filename, const void* data, size_t size) {
    FILE* fp = fopen(filename, "wb");
    if (!fp) return -1;
    
    size_t n = fwrite(data, 1, size, fp);
    fclose(fp);
    
    return (n == size) ? 0 : -1;
}

int main() {
    // 示例：读写文本文件
    const char* text = "Hello, 世界!\n第二行\n";
    
    // 写入文件（二进制模式，但内容可以是文本）
    if (write_file_safe("test.txt", text, strlen(text)) == 0) {
        printf("写入成功\n");
    }
    
    // 读取文件
    size_t size;
    char* content = read_file_safe("test.txt", &size);
    if (content) {
        printf("读取到 %zu 字节:\n%s", size, content);
        free(content);
    }
    
    return 0;
}

好了，关于文件I/O的跨平台问题，核心就是这些。记住一句话：二进制模式是跨平台的万能钥匙。不管你在哪个平台，不管文件是什么类型，用"b"标志总是最安全的。

---

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