5、文件操作与路径处理：跨平台文件API、路径分隔符与文件锁

文件操作，说白了就是程序跟磁盘打交道的那点事。但这事在跨平台场景下，坑特别多。我早年做一个嵌入式数据采集系统，Windows上开发得好好的，一移植到Linux，文件路径全崩了。嗯，从那以后，我对文件操作就格外小心。

今天咱们就聊聊三个核心问题：文件API怎么选、路径分隔符怎么处理、文件锁怎么跨平台。你想想看，这三个问题要是没处理好，代码换个平台就得重写，那还谈什么移植性？

5.1 跨平台文件API：fopen vs open

我个人习惯，90%的场景用fopen。为什么？因为它是C标准的一部分，所有平台都支持。而open是POSIX标准，Windows上虽然MinGW、Cygwin能用，但原生Windows API是CreateFile，不是open。

来看个对比：

// 标准C方式（推荐）
FILE *fp = fopen("data.txt", "rb");
if (fp == NULL) {
    perror("fopen failed");
    return -1;
}
fclose(fp);

// POSIX方式（不推荐跨平台）
int fd = open("data.txt", O_RDONLY | O_BINARY);
if (fd == -1) {
    perror("open failed");
    return -1;
}
close(fd);

我在项目中遇到过一个问题：Windows上fopen的"b"标志（二进制模式）很重要。如果不加，Windows会把'\n'自动转成'\r\n'，导致文件大小不一致。Linux上则完全忽略这个标志。所以，跨平台代码一律加"b"，哪怕你读的是文本文件。

API	跨平台性	缓冲	适用场景
fopen/fclose/fread/fwrite	全平台（C标准）	带缓冲	通用文件读写
open/close/read/write	POSIX系统，Windows需额外库	无缓冲	底层操作、文件锁、mmap
CreateFile/ReadFile（Windows）	仅Windows	可配置	Windows原生开发

5.2 路径分隔符处理：/ 还是 \？

这个问题，看着小，坑起来真要命。Windows用反斜杠'\'，Linux和macOS用正斜杠'/'。你写死一个路径，换个平台就炸。

我曾经接手过一个项目，代码里全是硬编码的"C:\\Users\\xxx\\data.txt"。拿到Linux上一编译，路径解析全错。改了一整天。

正确的做法是：代码里统一用正斜杠'/'。Windows的API其实也支持正斜杠，只是控制台和资源管理器默认用反斜杠。fopen("C:/Users/xxx/data.txt", "rb")在Windows上完全没问题。

// 推荐：统一用正斜杠
const char *path = "C:/Users/xxx/data.txt";

// 不推荐：硬编码反斜杠
const char *bad_path = "C:\\Users\\xxx\\data.txt";

// 如果需要拼接路径，用宏隔离
#ifdef _WIN32
    #define PATH_SEP "\\"
#else
    #define PATH_SEP "/"
#endif

还有一个细节：路径长度限制。Windows上经典路径最大260字符，Linux是4096。如果你要处理长路径，Windows需要加"\\?\"前缀。这个坑我踩过——一个日志文件路径超过260字符，fopen直接返回NULL，查了半天。

5.3 文件锁：跨平台怎么做？

文件锁，说白了就是防止多个进程同时写一个文件。标准C没有提供文件锁，所以你必须用平台相关API。

Linux上用flock或fcntl，Windows上用LockFileEx。嗯，这里要注意，flock是建议锁，不是强制锁。也就是说，其他进程如果不检查锁，照样能写。Windows的LockFileEx是强制锁，更严格。

// Linux：flock示例
#include <sys/file.h>
int fd = open("data.lock", O_CREAT | O_RDWR, 0666);
flock(fd, LOCK_EX);  // 加独占锁
// ... 写文件 ...
flock(fd, LOCK_UN);  // 解锁
close(fd);

// Windows：LockFileEx示例
#include <windows.h>
HANDLE hFile = CreateFile("data.lock", GENERIC_READ | GENERIC_WRITE,
    0, NULL, OPEN_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL);
OVERLAPPED ov = {0};
LockFileEx(hFile, LOCKFILE_EXCLUSIVE_LOCK, 0, MAXDWORD, MAXDWORD, &ov);
// ... 写文件 ...
UnlockFileEx(hFile, 0, MAXDWORD, MAXDWORD, &ov);
CloseHandle(hFile);

跨平台的做法，我一般封装一个简单的锁接口：

#ifdef _WIN32
    #include <windows.h>
    typedef HANDLE file_lock_t;
    #define lock_init(f)    CreateFile(f, ...)
    #define lock_acquire(h) LockFileEx(h, ...)
    #define lock_release(h) UnlockFileEx(h, ...)
    #define lock_destroy(h) CloseHandle(h)
#else
    #include <sys/file.h>
    typedef int file_lock_t;
    #define lock_init(f)    open(f, O_CREAT|O_RDWR, 0666)
    #define lock_acquire(h) flock(h, LOCK_EX)
    #define lock_release(h) flock(h, LOCK_UN)
    #define lock_destroy(h) close(h)
#endif

5.4 知识体系总览

下面这张图，把文件操作跨平台的核心逻辑串起来了。你看看，从API选择到路径处理，再到文件锁，每一步都有对应的策略。

5.5 实战建议

最后，给你几个我这些年总结出来的实战建议：

• 文件路径统一用正斜杠，别给自己找麻烦。Windows下99%的API都认正斜杠。
• fopen的"b"标志永远加上。Linux上没影响，Windows上能救命。
• 文件锁一定要统一机制。同一个项目里，要么全用flock，要么全用LockFileEx，别混用。
• 路径长度别超过260字符。如果一定要长路径，Windows下加"\\?\"前缀，但Linux下不用。
• 错误处理要到位。fopen返回NULL，别直接退出，先看看errno。我见过太多人忽略错误码了。

嗯，文件操作这块，说白了就是细心。你只要记住：标准库优先、路径统一、锁机制一致，跨平台文件操作就没那么可怕了。