C 语言预处理器：#define 宏定义与条件编译

C 语言的预处理器在编译前对源代码进行文本替换和条件筛选。它不理解 C 语法，只做纯文本处理。掌握 #define 宏定义和条件编译，能让你写出更灵活、可移植、易调试的代码。

使用 #define 定义常量和简单宏

定义一个常量最常用的方式是使用 #define。它的基本格式是：

#define 标识符 替换文本

输入以下代码到 main.c 文件中：

#include <stdio.h>

#define PI 3.14159
#define MAX_SIZE 100

int main() {
    double area = PI * 5 * 5;
    int buffer[MAX_SIZE];
    printf("Area: %f\n", area);
    printf("Buffer size: %d\n", MAX_SIZE);
    return 0;
}

预处理器会把所有 PI 替换成 3.14159，把 MAX_SIZE 替换成 100，然后再交给编译器。这种方式比用 const 变量更轻量（不占运行时内存），也比直接写“魔法数字”更清晰。

注意：#define 后面不要加分号。如果写了 #define PI 3.14159;，那么每次用 PI 都会多出一个分号，导致语法错误。

编写带参数的函数式宏

你可以定义类似函数的宏，用于简单计算或重复逻辑。

定义一个计算平方的宏：

#define SQUARE(x) ((x) * (x))

使用它：

int a = 5;
int result = SQUARE(a + 1); // 展开为 ((a + 1) * (a + 1))，结果是 36

关键细节：

• 参数 x 必须用括号包裹，防止运算符优先级错误。
• 整个表达式也要用括号包裹，避免在更大表达式中出错。

对比错误写法：

#define SQUARE_BAD(x) x * x
int bad = SQUARE_BAD(3 + 2); // 展开为 3 + 2 * 3 + 2 = 3 + 6 + 2 = 11（错误！）

所以，始终给参数和整体表达式加括号。

利用条件编译控制代码段

条件编译让你根据预定义的符号决定是否编译某段代码。最常用的是 #ifdef、#ifndef 和 #if。

基础用法：调试开关

设置一个调试模式：

#define DEBUG

int main() {
#ifdef DEBUG
    printf("Debug mode enabled.\n");
#endif

    // 正常逻辑
    return 0;
}

当你移除 #define DEBUG 这一行，printf 就不会被编译进程序，零运行时开销。

多分支选择：#if、#elif、#else

根据版本号启用不同功能：

#define VERSION 2

int main() {
#if VERSION == 1
    printf("Using legacy algorithm.\n");
#elif VERSION == 2
    printf("Using optimized algorithm.\n");
#else
    printf("Unknown version.\n");
#endif
    return 0;
}

预处理器会计算 #if 后的表达式（必须是整型常量表达式），只保留一个分支。

防止头文件重复包含

这是 #ifndef 的经典用途。创建 myheader.h：

#ifndef MYHEADER_H
#define MYHEADER_H

// 所有头文件内容放在这里
int global_var;

#endif // MYHEADER_H

第一次包含时，MYHEADER_H 未定义，于是定义它并包含内容。再次包含时，#ifndef 条件为假，跳过整个块，避免重复定义错误。

高级技巧与注意事项

字符串化与连接操作

预处理器支持两个特殊操作符：

• #：将宏参数转换为字符串字面量（字符串化）
• ##：将两个标记拼接成一个（连接）

示例：自动打印变量名和值

#include <stdio.h>

#define PRINT_VALUE(x) printf(#x " = %d\n", (x))

int main() {
    int score = 95;
    PRINT_VALUE(score); // 输出: score = 95
    return 0;
}

这里 #x 把 score 变成 "score"，然后与后面的字符串字面量自动拼接。

连接操作示例：

#define DECLARE_VAR(n) int var_##n = n

DECLARE_VAR(10); // 展开为 int var_10 = 10;

宏的副作用

宏是文本替换，可能多次求值参数，导致意外行为。

避免以下写法：

#define MAX(a, b) ((a) > (b) ? (a) : (b))

int x = 1, y = 2;
int m = MAX(x++, y++); // x 和 y 可能被递增两次！

在这种场景下，改用内联函数更安全：

static inline int max(int a, int b) {
    return a > b ? a : b;
}

预定义宏

编译器自动定义了一些宏，可用于调试或平台适配：

结合使用：

#define LOG(msg) printf("[%s:%d] %s\n", __FILE__, __LINE__, msg)

int main() {
    LOG("Program started");
    return 0;
}

输出类似：[main.c:5] Program started

实战：跨平台代码适配

假设你要写一个清除屏幕的函数，Windows 用 system("cls")，Linux/macOS 用 system("clear")。

编写如下代码：

#include <stdlib.h>

#ifdef _WIN32
    #define CLEAR_SCREEN system("cls")
#else
    #define CLEAR_SCREEN system("clear")
#endif

int main() {
    CLEAR_SCREEN;
    return 0;
}

_WIN32 是 Windows 编译器（如 MSVC、MinGW）自动定义的宏。这样一份代码就能在多个平台编译运行。

检查宏是否已定义

除了 #ifdef，你还可以用 #if defined(...) 实现更复杂的逻辑：

#if defined(DEBUG) && defined(VERBOSE)
    printf("Detailed debug info\n");
#endif

这比嵌套 #ifdef 更简洁。

删除宏定义

用 #undef 可以取消之前的 #define：

#define TEMP 100
// ... 使用 TEMP ...

#undef TEMP
// 此后 TEMP 不再有效

这在需要临时覆盖宏定义时有用。

编译时传入宏定义

你不必修改源码就能定义宏。使用 GCC 编译时：

gcc -DDEBUG -DMAX_THREADS=8 main.c -o app

等价于在代码开头加上：

#define DEBUG
#define MAX_THREADS 8

这对构建不同配置（如开发版/发布版）非常方便。

最佳实践总结

1. 常量用 #define，但复杂类型或需类型检查时用 const。
2. 函数式宏务必加括号：参数和整体表达式都要括起来。
3. 避免有副作用的宏参数，优先考虑内联函数。
4. 用 #ifndef 包裹头文件，防止重复包含。
5. 调试代码用 #ifdef DEBUG 包围，发布时自动剔除。
6. 跨平台代码用条件编译隔离，保持主逻辑干净。
7. 编译时用 -D 定义宏，实现无侵入式配置切换。