3、预处理与宏定义：跨平台中的 #ifdef、#ifndef、#pragma once 用法，平台宏检测（_WIN32, __linux__, __APPLE__）

预处理，说白了就是编译前的文本替换阶段。很多新手觉得这玩意儿就是简单的“找找替换”，其实不然。在我十几年的C语言跨平台开发经历中，预处理指令是解决平台差异的第一道防线，也是最灵活、最容易被滥用的工具。

今天我们就来聊聊，怎么用好 #ifdef、#ifndef、#pragma once，以及如何通过平台宏检测写出真正可移植的代码。

3.1 条件编译：#ifdef 与 #ifndef

#ifdef 和 #ifndef 是预处理中最常用的条件判断指令。它们的作用很简单：检查某个宏是否被定义。

• #ifdef MACRO：如果 MACRO 被定义，则编译后续代码
• #ifndef MACRO：如果 MACRO 未被定义，则编译后续代码

我个人习惯把 #ifdef 用在“平台特有代码”的包裹上。举个例子：

#ifdef _WIN32
    // Windows 特有的 API 调用
    Sleep(1000);  // Windows 下休眠 1 秒
#elif __linux__
    // Linux 特有的 API 调用
    sleep(1);     // Linux 下休眠 1 秒
#elif __APPLE__
    // macOS 特有的 API 调用
    usleep(1000000);  // macOS 下休眠 1 秒
#endif

你看，同样的“休眠1秒”，三个平台用了三个不同的函数。没有条件编译，你只能写三份不同的源文件——那维护起来可就头疼了。

3.2 #pragma once：头文件保护的最佳实践

头文件重复包含是C语言开发中常见的坑。你想想看，一个头文件被包含了两次，里面的结构体定义、函数声明就重复了，编译器直接报错。

传统做法是用 #ifndef 做头文件保护：

#ifndef MY_HEADER_H
#define MY_HEADER_H

// 头文件内容

#endif /* MY_HEADER_H */

但这种方式有个小问题：你需要自己起一个唯一的宏名字。万一跟别的头文件冲突了呢？我在项目中就遇到过两次，两个不同模块的头文件都用了 #ifndef CONFIG_H，结果其中一个直接被跳过了，编译出来的行为完全不对。

所以，我个人更推荐用 #pragma once：

#pragma once

// 头文件内容

一行搞定，编译器自己会处理重复包含的问题。而且它比 #ifndef 方式更快——编译器不需要打开文件去检查宏定义，直接跳过即可。

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

跨平台开发的核心，就是知道当前编译目标是什么系统。编译器会预定义一些宏，我们可以直接拿来用。

宏名称	对应平台	备注
_WIN32	Windows（32位和64位）	MSVC、MinGW 都定义此宏
_WIN64	Windows 64位	仅在64位编译时定义
__linux__	Linux	GCC、Clang 都定义此宏
__APPLE__	macOS / iOS	注意：macOS 下还定义了 __MACH__
__unix__	类 Unix 系统	包括 Linux、macOS、FreeBSD 等

嗯，这里要注意：_WIN32 这个名字有点误导人。它虽然叫 _WIN32，但在64位 Windows 下也会被定义。如果你想区分32位和64位，需要额外检查 _WIN64。

我曾经在做一个跨平台网络库时，就踩过这个坑。代码里写了：

#ifdef _WIN32
    // 使用 32 位指针
    void* ptr = malloc(4);
#endif

结果在64位 Windows 上编译，指针还是只分配了4字节，程序跑起来就崩。后来改成：

#ifdef _WIN64
    // 64 位指针
    void* ptr = malloc(8);
#elif _WIN32
    // 32 位指针
    void* ptr = malloc(4);
#endif

这才解决问题。所以，永远不要假设 _WIN32 只代表32位。

3.4 实战：一个跨平台的文件路径处理

光说不练假把式。我们来看一个实际例子：文件路径分隔符的处理。

Windows 用反斜杠 \，Linux 和 macOS 用正斜杠 /。如果你写死了路径分隔符，换到另一个平台就废了。

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

// 根据平台定义路径分隔符
#ifdef _WIN32
    #define PATH_SEPARATOR '\\'
    #define PATH_SEPARATOR_STR "\\"
#else
    #define PATH_SEPARATOR '/'
    #define PATH_SEPARATOR_STR "/"
#endif

void normalize_path(char* path) {
    // 将路径中的分隔符统一为当前平台格式
    for (int i = 0; path[i] != '\0'; i++) {
#ifdef _WIN32
        if (path[i] == '/') {
            path[i] = PATH_SEPARATOR;
        }
#else
        if (path[i] == '\\') {
            path[i] = PATH_SEPARATOR;
        }
#endif
    }
}

int main() {
    char path[] = "data/config/settings.ini";
    normalize_path(path);
    printf("Normalized path: %s\n", path);
    return 0;
}

你看，通过 #ifdef 我们只写了一份代码，但它在三个平台上都能正确工作。Windows 下路径会变成 data\config\settings.ini，Linux 和 macOS 下保持 data/config/settings.ini。

3.5 知识体系图

下面这张图展示了预处理与宏定义在跨平台开发中的核心逻辑：

3.6 避坑指南

最后，分享几个我踩过的坑，希望能帮你少走弯路：

• 宏名字冲突：我曾经在一个大型项目中，两个头文件都定义了 #define VERSION "1.0"，结果编译时后定义的覆盖了前定义的，导致版本号错乱。建议给宏加模块前缀，比如 NETWORK_VERSION。
• 忘记 #endif：条件编译嵌套多了，很容易漏掉 #endif。我建议每个 #endif 后面都加上注释，标明它对应哪个 #ifdef。
• 滥用 #ifdef：有些人喜欢把所有平台差异都用 #ifdef 包裹，结果代码里到处都是条件编译，可读性极差。我的原则是：能用函数抽象的就用函数，只在函数内部用 #ifdef。
• 忽略编译器差异：同样是 __linux__，GCC 和 Clang 都定义它，但某些细节行为可能不同。跨平台测试时，记得在不同编译器上都跑一遍。

预处理是C语言跨平台开发的基石。用好 #ifdef、#ifndef、#pragma once 和平台宏检测，你就能写出“一次编写，到处编译”的代码。记住，预处理解决的是编译时的问题，别让它去处理运行时的事情。

---

公众号:蓝海资料掘金营，微信deep3321