29、跨平台文件操作：路径分隔符处理、换行符处理、使用预处理宏实现跨平台

说到跨平台文件操作，我估计不少朋友都踩过坑。我自己就曾经在一个项目里，代码在Windows上跑得好好的，一放到Linux服务器上就崩了。查了半天，原来是路径分隔符和换行符在搞鬼。嗯，今天咱们就把这块彻底讲清楚。

29.1 跨平台文件操作的痛点

说白了，不同操作系统对文件的操作方式有三大差异：

• 路径分隔符不同：Windows用反斜杠 \，Linux/macOS用正斜杠 /
• 换行符不同：Windows用 \r\n，Linux用 \n，macOS（旧版）用 \r
• API行为差异：比如文件权限、文件锁等

你想想看，如果你的代码里硬编码了 "C:\\Users\\test.txt"，那到了Linux上肯定找不到文件。所以，跨平台文件操作的核心就是——用预处理宏和标准库来屏蔽这些差异。

29.2 路径分隔符处理

我在项目中遇到过最典型的场景：一个配置文件路径，Windows下是 config\app.ini，Linux下是 config/app.ini。如果代码里写死了，那移植起来简直要命。

解决方案其实很简单——用预处理宏定义路径分隔符：

#ifdef _WIN32
    #define PATH_SEPARATOR '\\'
    #define PATH_SEPARATOR_STR "\\"
#else
    #define PATH_SEPARATOR '/'
    #define PATH_SEPARATOR_STR "/"
#endif

// 使用示例
void build_path(char *buffer, size_t size, const char *dir, const char *filename) {
    snprintf(buffer, size, "%s%c%s", dir, PATH_SEPARATOR, filename);
}

嗯，这里要注意：_WIN32 这个宏在Windows上（包括32位和64位）都会被定义。Linux和macOS上则不会。所以用它做条件编译非常靠谱。

29.3 换行符处理

换行符的问题更隐蔽。我曾经在Windows上写了一个日志文件，每行结尾是 \r\n。结果同事在Linux上用 cat 查看，每行末尾都多了一个 ^M 符号。虽然不影响程序读取，但看着就是不舒服。

解决换行符问题，有两种思路：

1. 文本模式 vs 二进制模式：在Windows上用 fopen("file.txt", "w") 时，C标准库会自动把 \n 转换成 \r\n。但Linux上不会。所以如果你用文本模式写文件，Windows上得到的是 \r\n，Linux上得到的是 \n。
2. 统一使用二进制模式：用 fopen("file.txt", "wb") 或 "rb"，然后自己控制换行符的写入。

我个人建议：如果文件需要在不同平台间交换，统一用二进制模式 + 显式写入 \n。这样写出来的文件在所有平台上都是 \n 结尾，兼容性最好。

// 跨平台换行符写入
void write_line(FILE *fp, const char *line) {
    fputs(line, fp);
    fputc('\n', fp);  // 统一写 \n
}

// 或者用预处理宏控制
#ifdef _WIN32
    #define NEWLINE "\r\n"
#else
    #define NEWLINE "\n"
#endif

void write_line_ex(FILE *fp, const char *line) {
    fputs(line, fp);
    fputs(NEWLINE, fp);
}

29.4 使用预处理宏实现跨平台

预处理宏是C语言跨平台开发的利器。说白了，就是让编译器在编译阶段根据目标平台选择不同的代码路径。我常用的宏有这些：

宏名称	定义平台	说明
_WIN32	Windows (32/64位)	最常用的Windows检测宏
__linux__	Linux	GCC在Linux上自动定义
__APPLE__	macOS / iOS	Apple平台通用宏
__unix__	类Unix系统	包括Linux、macOS等

一个完整的跨平台文件操作封装，大概长这样：

#ifndef PLATFORM_H
#define PLATFORM_H

// 路径分隔符
#ifdef _WIN32
    #define PATH_SEP '\\'
    #define PATH_SEP_STR "\\"
#else
    #define PATH_SEP '/'
    #define PATH_SEP_STR "/"
#endif

// 换行符
#ifdef _WIN32
    #define LINE_END "\r\n"
#else
    #define LINE_END "\n"
#endif

// 文件打开模式（二进制模式统一）
#ifdef _WIN32
    #define FOPEN_READ_BINARY  "rb"
    #define FOPEN_WRITE_BINARY "wb"
#else
    #define FOPEN_READ_BINARY  "rb"
    #define FOPEN_WRITE_BINARY "wb"
#endif

// 跨平台文件操作函数
static inline FILE* platform_fopen(const char *path, const char *mode) {
    return fopen(path, mode);
}

static inline int platform_remove(const char *path) {
    return remove(path);
}

#endif // PLATFORM_H

29.5 实战：跨平台配置文件读写

咱们来写一个完整的例子。假设我们要读写一个配置文件 config/app.ini，要求Windows和Linux都能用：

#include <stdio.h>
#include <string.h>
#include "platform.h"

#define CONFIG_DIR  "config"
#define CONFIG_FILE "app.ini"

void build_config_path(char *buffer, size_t size) {
    snprintf(buffer, size, "%s%c%s", 
             CONFIG_DIR, PATH_SEP, CONFIG_FILE);
}

int write_config(const char *key, const char *value) {
    char path[256];
    build_config_path(path, sizeof(path));
    
    FILE *fp = platform_fopen(path, FOPEN_WRITE_BINARY);
    if (!fp) return -1;
    
    fprintf(fp, "%s=%s%s", key, value, LINE_END);
    fclose(fp);
    return 0;
}

int read_config(const char *key, char *value, size_t size) {
    char path[256];
    build_config_path(path, sizeof(path));
    
    FILE *fp = platform_fopen(path, FOPEN_READ_BINARY);
    if (!fp) return -1;
    
    char line[256];
    while (fgets(line, sizeof(line), fp)) {
        // 去掉换行符（兼容 \r\n 和 \n）
        size_t len = strlen(line);
        while (len > 0 && (line[len-1] == '\n' || line[len-1] == '\r')) {
            line[--len] = '\0';
        }
        
        char *sep = strchr(line, '=');
        if (sep && strncmp(line, key, sep - line) == 0) {
            strncpy(value, sep + 1, size - 1);
            value[size - 1] = '\0';
            fclose(fp);
            return 0;
        }
    }
    
    fclose(fp);
    return -1;  // 没找到
}

你看，这里用了 PATH_SEP 来拼接路径，用了 LINE_END 来写换行，用了 FOPEN_WRITE_BINARY 来统一打开模式。这段代码在Windows和Linux上都能编译运行，而且行为一致。

29.6 知识体系图

下面这张图总结了跨平台文件操作的核心逻辑：

说白了，跨平台文件操作就是三步：识别平台 → 宏替换 → 统一行为。预处理阶段把平台相关的差异都处理掉，剩下的代码逻辑完全一致。

29.7 避坑指南

最后，分享几个我踩过的坑：

• 不要用 \\ 硬编码路径：我曾经在代码里写死了 "data\\file.txt"，结果Linux上编译通过但运行时找不到文件。后来改成用宏定义，再也没出过问题。
• 注意 fopen 的 mode 参数：Windows上 "w" 和 "wb" 行为不同，前者会转换换行符。如果你要写二进制数据，一定要用 "wb"。
• 跨平台文件共享时统一用 \n：我建议所有跨平台交换的文件都用 \n 作为换行符。这样不管在哪个系统上打开，都不会出现乱码或多余的 ^M。
• 测试要在所有目标平台上跑一遍：预处理宏只能解决编译时的问题，运行时行为（比如文件权限、磁盘空间不足）还是要靠实际测试来验证。

---