3. 预处理器的跨平台陷阱：宏定义与平台检测

预处理阶段，是C语言编译的第一道关卡。很多人觉得它简单，不就是个文本替换嘛。但说实话，跨平台开发中90%的编译错误，都跟预处理器有关。我见过太多项目，在Windows上编译好好的，换到Linux就崩了——查到最后，往往是宏定义在搞鬼。

3.1 平台检测宏：_WIN32、linux、APPLE

不同操作系统，预定义了一些宏。我们可以用它们来判断当前编译环境。这是跨平台开发的基础操作。

常用平台宏一览

宏名称	适用平台	备注
_WIN32	Windows（32位和64位）	注意：64位Windows也定义_WIN32
_WIN64	Windows 64位	仅64位系统定义
__linux__	Linux	GCC/Clang都支持
__APPLE__	macOS / iOS	包含所有Apple平台
__MACH__	macOS（底层）	常与__APPLE__配合使用
__unix__	类Unix系统	包含Linux、macOS等

我个人习惯这样写平台检测代码：

#if defined(_WIN32) || defined(_WIN64)
    // Windows 专用代码
    #include <windows.h>
#elif defined(__linux__)
    // Linux 专用代码
    #include <unistd.h>
#elif defined(__APPLE__)
    // macOS 专用代码
    #include <TargetConditionals.h>
    #if TARGET_OS_IPHONE
        // iOS 专用
    #else
        // macOS 专用
    #endif
#else
    #error "不支持的平台！"
#endif

避坑指南：我曾经在项目中犯过一个低级错误——用 __linux 代替 __linux__。少写两个下划线，编译器根本不认。结果代码在Linux上走了Windows分支，编译直接报错。记住：这些宏的下划线数量是固定的，一个都不能少。

3.2 #pragma once 与头文件保护

头文件重复包含，是老生常谈的问题。有两种主流写法：#pragma once 和传统的宏保护。

传统写法（宏保护）：

// myheader.h
#ifndef MYHEADER_H
#define MYHEADER_H

// 头文件内容...

#endif // MYHEADER_H

现代写法（#pragma once）：

// myheader.h
#pragma once

// 头文件内容...

你可能会问：哪个更好？嗯，这里要注意几点。

#pragma once 更简洁，不会写错宏名。几乎所有现代编译器都支持（GCC、Clang、MSVC）。
宏保护 是C89标准就支持的，兼容性最好。一些老旧的嵌入式编译器可能不认识 #pragma once。
性能上，#pragma once 通常更快——编译器读到这个标记后，直接跳过整个文件，不用打开文件去比对宏。

我的建议：新项目直接用 #pragma once。如果项目需要兼容上古编译器（比如某些工业控制设备），那就老老实实用宏保护。我个人在团队里定了个规矩：统一用 #pragma once，除非有特殊需求。

3.3 条件编译的最佳实践

条件编译用好了是神器，用不好就是灾难。我见过一个项目，一个.c文件里嵌套了七八层 #ifdef，读起来跟迷宫一样。

几个实用原则：

把平台差异封装成函数，不要到处写 #ifdef。
用宏控制功能开关，而不是控制具体实现。
给每个条件分支写注释，说明为什么需要这个分支。

举个例子，假设我们需要一个获取当前时间的函数：

// 坏写法：到处散落 #ifdef
void log_message(const char* msg) {
    #ifdef _WIN32
        SYSTEMTIME st;
        GetLocalTime(&st);
        printf("[%02d:%02d:%02d] %s\n", st.wHour, st.wMinute, st.wSecond, msg);
    #else
        time_t t = time(NULL);
        struct tm* tm_info = localtime(&t);
        printf("[%02d:%02d:%02d] %s\n", tm_info->tm_hour, tm_info->tm_min, tm_info->tm_sec, msg);
    #endif
}

// 好写法：封装成平台函数
#ifdef _WIN32
    #include <windows.h>
    void get_time_str(char* buf, size_t size) {
        SYSTEMTIME st;
        GetLocalTime(&st);
        snprintf(buf, size, "%02d:%02d:%02d", st.wHour, st.wMinute, st.wSecond);
    }
#else
    #include <time.h>
    void get_time_str(char* buf, size_t size) {
        time_t t = time(NULL);
        struct tm* tm_info = localtime(&t);
        snprintf(buf, size, "%02d:%02d:%02d", tm_info->tm_hour, tm_info->tm_min, tm_info->tm_sec);
    }
#endif

void log_message(const char* msg) {
    char time_buf[16];
    get_time_str(time_buf, sizeof(time_buf));
    printf("[%s] %s\n", time_buf, msg);
}

你看，第二种写法里，log_message 函数本身没有任何 #ifdef。平台差异被隔离在 get_time_str 这一个函数里。以后要加新平台，只需要改这一个地方。

避坑指南：我曾经接手过一个项目，代码里到处都是 #ifdef DEBUG 和 #ifdef RELEASE。结果有一次发布版本时，编译脚本忘了定义 RELEASE 宏，导致所有 #ifdef RELEASE 的代码都没编译进去——程序直接少了一半功能。从那以后，我坚持用 #ifndef NDEBUG 这种标准方式，而不是自定义宏。

3.4 知识体系总览

下面这张图，帮你理清预处理器跨平台开发的核心逻辑：

最后说一句：预处理器是C语言的「元编程」工具。用得好，代码优雅跨平台；用不好，代码变成一团乱麻。记住一个原则：能用函数解决的，就别用宏；能在一个地方判断平台，就别分散到各处。

可可精品资料库

📚 课程目录

3. 预处理器的跨平台陷阱：宏定义与平台检测

3.1 平台检测宏：_WIN32、__linux__、__APPLE__

3.2 #pragma once 与头文件保护

3.3 条件编译的最佳实践

3.4 知识体系总览

3.1 平台检测宏：_WIN32、linux、APPLE