跨平台文件操作：Windows与Linux文件API差异

做嵌入式开发这些年，我最大的感触就是——跨平台移植永远是个绕不开的坑。你想想看，代码在Linux上跑得好好的，一放到Windows上就崩了。嗯，我当年第一次遇到这个问题时，整整排查了两天，最后发现只是fopen的参数写错了。

今天咱们就来聊聊Windows和Linux在文件操作上的那些差异。说白了，就是三个核心问题：API函数名不同、路径分隔符不一样、换行符的处理方式有区别。

一、文件API差异：名字不同，功能相似

Windows和Linux都提供了文件操作的API，但函数名和参数细节有差异。我整理了一个对照表，方便你快速查阅：

功能	Linux/POSIX	Windows
打开文件	open()	CreateFile()
读取文件	read()	ReadFile()
写入文件	write()	WriteFile()
关闭文件	close()	CloseHandle()
定位文件	lseek()	SetFilePointer()
获取文件大小	stat()	GetFileSize()

你看，功能上基本是对应的，但名字完全不同。我个人习惯的做法是——封装一层抽象层，用条件编译来切换底层实现。

#ifdef _WIN32
    #include <windows.h>
    typedef HANDLE FileHandle;
    #define INVALID_FILE_HANDLE INVALID_HANDLE_VALUE
#else
    #include <fcntl.h>
    #include <unistd.h>
    #include <sys/stat.h>
    typedef int FileHandle;
    #define INVALID_FILE_HANDLE (-1)
#endif

FileHandle open_file(const char* path, int flags) {
#ifdef _WIN32
    DWORD access = 0;
    if (flags & O_RDONLY) access |= GENERIC_READ;
    if (flags & O_WRONLY) access |= GENERIC_WRITE;
    return CreateFile(path, access, 0, NULL, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, NULL);
#else
    return open(path, flags, 0644);
#endif
}

二、路径分隔符：反斜杠 vs 正斜杠

这个问题看着小，但坑起来真要命。Windows用反斜杠\，Linux用正斜杠/。你可能会说：「那我都用正斜杠不就行了？」

嗯，理论上可以。Windows的API其实也支持正斜杠，但有些第三方库和旧版系统不认。我曾经在一个项目里，就因为路径里混用了两种分隔符，导致文件死活打不开——最后发现是字符串拼接时多了一个反斜杠。

我的建议是：在代码里统一用正斜杠，然后在需要的时候做转换。

#include <string.h>

void normalize_path(char* path) {
#ifdef _WIN32
    for (int i = 0; path[i] != '\0'; i++) {
        if (path[i] == '/') {
            path[i] = '\\';
        }
    }
#endif
}

另外，Windows还有盘符的概念，比如C:\。Linux没有这个。所以如果你要处理绝对路径，得额外注意。

三、换行符差异：\n vs \r\n

这个问题，说白了就是历史遗留问题。Linux用\n（LF），Windows用\r\n（CR+LF）。如果你在Windows上写了一个文本文件，拿到Linux上打开，每行末尾会多一个\r字符。反过来，Linux的文件在Windows上打开，所有内容会挤在一行。

标准C库的fopen有个模式参数可以解决这个问题：

• "r" / "w"：文本模式，自动转换换行符
• "rb" / "wb"：二进制模式，不转换

但如果你用系统API（比如open / CreateFile），就得自己处理了。我个人习惯是：所有跨平台传输的文件都用二进制模式，然后自己定义换行符规则。

// 自定义换行符处理
void write_line(FileHandle fd, const char* line) {
    write(fd, line, strlen(line));
#ifdef _WIN32
    const char* newline = "\r\n";
#else
    const char* newline = "\n";
#endif
    write(fd, newline, strlen(newline));
}

四、知识体系总览

下面这张图，是我整理的跨平台文件操作的核心逻辑。你可以把它当作一个快速参考：

五、实战建议：如何写出可移植的代码

说了这么多，最后给你几条我这些年总结出来的实战建议：

1. 用标准C库代替系统API——fopen、fread、fwrite这些函数在Windows和Linux上行为一致，能省去很多麻烦。只有当你需要高级功能（比如异步IO、内存映射）时，才考虑系统API。
2. 路径处理统一用正斜杠——在代码里写死/，然后在输出到系统API前做一次转换。这样代码可读性更好，也更容易维护。
3. 二进制模式是跨平台的保险选择——如果你不确定文件是文本还是二进制，就用二进制模式。虽然换行符要自己处理，但至少不会出现数据被篡改的问题。
4. 用条件编译隔离平台代码——把平台相关的代码放到单独的.c文件里，用#ifdef _WIN32或#ifdef __linux__来区分。这样主逻辑代码可以保持干净。