3、预处理器与平台宏：_WIN32、__linux__、__APPLE__等宏的使用、条件编译实战

跨平台开发，说白了就是「一套代码，到处编译」。但不同操作系统底层的 API、数据类型、甚至字节序都不一样，怎么办？

答案就在预处理器和平台宏里。我个人习惯把预处理器看作「编译期的 if-else」，它能在代码交给编译器之前，就帮你把不同平台的代码分支切好。今天我们就来聊聊 _WIN32、__linux__、__APPLE__ 这些宏怎么用，以及条件编译的实战技巧。

3.1 平台宏的本质：谁定义了它们？

这些宏不是你自己定义的，而是编译器或系统头文件预定义的。比如：

• _WIN32：Windows 平台（包括 32 位和 64 位）的编译器都会定义它。注意，它没有双下划线前缀，这是历史原因。
• __linux__：Linux 平台下 GCC/Clang 都会定义。
• __APPLE__：macOS、iOS 等 Apple 平台都会定义。通常还要配合 __MACH__ 一起用。
• __ANDROID__：Android NDK 环境下定义。

我在项目中遇到过有人把 _WIN32 写成 __WIN32__，结果在 MSVC 下编译通过，换到 MinGW 就报错。嗯，这里要注意：宏的名字是固定的，大小写和下划线数量都不能错。

3.2 条件编译的基本语法

条件编译靠的是 #if、#ifdef、#ifndef、#elif、#else、#endif 这些指令。我常用的模式有两种：

3.2.1 #ifdef / #ifndef 模式

这种写法最简单：检查某个宏是否被定义。

#ifdef _WIN32
    // Windows 专用代码
    #include <windows.h>
#elif defined(__linux__)
    // Linux 专用代码
    #include <unistd.h>
#elif defined(__APPLE__)
    // macOS 专用代码
    #include <TargetConditionals.h>
#else
    #error "Unsupported platform!"
#endif

3.2.2 #if 表达式模式

这种更灵活，可以检查宏的值，或者组合多个条件。

#if _WIN32
    // 注意：_WIN32 的值通常是 1
    const char* os = "Windows";
#elif __linux__
    const char* os = "Linux";
#elif __APPLE__
    const char* os = "macOS";
#endif

3.3 实战：封装一个跨平台的文件路径处理函数

光说不练假把式。我们来看一个真实场景：文件路径分隔符。Windows 用反斜杠 \，Linux/macOS 用正斜杠 /。

#include <string>
#include <algorithm>

std::string normalizePath(const std::string& path) {
    std::string result = path;
    
#ifdef _WIN32
    // Windows 下：把正斜杠转成反斜杠
    std::replace(result.begin(), result.end(), '/', '\\');
#else
    // Linux/macOS 下：把反斜杠转成正斜杠
    std::replace(result.begin(), result.end(), '\\', '/');
#endif
    
    return result;
}

这段代码看起来简单，但我在实际项目中踩过坑。有一次，我在 Windows 上用 MinGW 编译，结果 _WIN32 没定义——因为 MinGW 模拟的是 Linux 环境。后来我查了文档才发现，MinGW 下要同时检查 __MINGW32__。所以，不要假设编译器行为。

3.4 平台宏的常见组合与陷阱

目标平台	常用宏	注意事项
Windows (MSVC)	_WIN32	64 位下也是 _WIN32，不是 _WIN64
Windows (MinGW)	_WIN32, __MINGW32__	建议同时检查两者
Linux	__linux__	部分编译器也定义 linux（不带下划线），但已废弃
macOS	__APPLE__, __MACH__	需要包含 TargetConditionals.h
iOS	__APPLE__, TARGET_OS_IPHONE	真机和模拟器宏不同
Android	__ANDROID__	NDK 环境下定义

3.5 条件编译的进阶技巧

3.5.1 使用宏定义统一接口

我经常用宏来隐藏平台差异，对外暴露统一接口：

#ifdef _WIN32
    #define PLATFORM_SLEEP(ms) Sleep(ms)
#else
    #include <unistd.h>
    #define PLATFORM_SLEEP(ms) usleep((ms) * 1000)
#endif

// 使用时，直接调用 PLATFORM_SLEEP(1000) 即可

3.5.2 编译时断言与平台检测

有时候，你需要在编译期就确保某些条件成立。可以用 static_assert 配合平台宏：

static_assert(sizeof(void*) == 8, "This code requires 64-bit platform");

#if defined(_WIN32) && !defined(_WIN64)
    #error "32-bit Windows is not supported"
#endif

3.5.3 调试与发布的条件编译

除了平台宏，我们还可以用自定义宏来控制调试输出：

#ifdef _DEBUG
    #define LOG_DEBUG(msg) std::cerr << "[DEBUG] " << msg << std::endl
#else
    #define LOG_DEBUG(msg) // 空操作
#endif

3.6 知识体系总览

下面这张图总结了本章的核心内容，从平台宏的定义到条件编译的实战应用：

3.7 总结与个人体会

条件编译是跨平台开发的基石。你想想看，如果没有这些宏，我们得维护三套代码，那简直是噩梦。

我个人总结了三条铁律：

1. 先查文档，再写代码——不同编译器的预定义宏列表可以在官方文档找到，别靠猜。
2. 能少写就少写——条件编译块越多，代码可读性越差。能用抽象层解决的，就别到处 #ifdef。
3. 测试每个平台——我在项目里吃过亏：Windows 下编译通过，Linux 下忘了包含头文件，结果报错。所以 CI 里一定要覆盖所有目标平台。

---