首页 > 编程笔记 > C语言笔记 阅读：12

C语言中的#if、#elif、#else和#endif条件编译（非常详细，附带实例）

条件编译是 C语言预处理器（preprocessor）的一项功能，允许在编译阶段根据特定条件决定哪些代码被编译，哪些被忽略。


C语言提供的条件编译指令包括 #if、#elif、#else 和 #endif，这些指令经常在 C 语言程序中存储，尤其是跨平台开发、调试或代码版本管理中。

条件编译的基本语法

条件编译的语法类似于运行时的 if else 条件语句，但以 # 开头，表示预处理器指令。基本结构如下：

#if 条件表达式
    // 条件为真时编译的代码
#elif 条件表达式
    // 第一个条件为假，此条件为真时编译的代码
#else
    // 所有条件为假时编译的代码
#endif


条件表达式通常是常量、宏或简单的算术/逻辑运算，结果为 0（假）或非 0（真）。条件表达式中常用的运算符如下表所示：
 

运算符 说明
defined 检查宏是否定义，返回 1 或 0
==, != 比较宏值是否相等或不等
&&, ||, ! 逻辑与、或、非
>, <, >=, <= 大小比较


例如，#if defined(DEBUG) && DEBUG_LEVEL > 0 表示调试启用且级别大于 0。


虽然条件编译的语法结构和运行时的 if else 语句非常类似，但它是在编译之前就对源代码进行筛选。


【实例 1】最简单的用法是根据宏是否定义来控制代码。例如，启用调试信息：

#include <stdio.h>

#define DEBUG 1  // 定义调试开关

int main() {
    int x = 10;
#if DEBUG
    printf("Debug: x = %d\n", x);
#endif
    printf("Program running...\n");
    return 0;
}

输出结果：

Debug: x = 10
Program running...

这里，#if DEBUG 检查 DEBUG 的值。因为 DEBUG 定义为 1（非 0），条件为真，调试代码被编译。如果注释掉 #define DEBUG 1，调试信息将被排除。


【实例 2】#defined 运算符检查宏是否被定义，常与 #if 结合使用。例如： 
#include <stdio.h>

#define VERSION 2

int main() {
#if defined(VERSION)
    printf("Version is defined: %d\n", VERSION);
#else
    printf("Version is not defined\n");
#endif
    return 0;
}

输出结果：

Version is defined: 2

#if defined(VERSION) 检查 VERSION 是否定义，无论其值是什么，只要存在就为真。可以用 !defined 表示“未定义”。


【实例 3】使用 #elif 和 #else 可以实现多分支选择。例如，根据版本号选择代码：

#include <stdio.h>

#define VERSION 2

int main() {
#if VERSION == 1
    printf("This is Version 1\n");
#elif VERSION == 2
    printf("This is Version 2\n");
#elif VERSION == 3
    printf("This is Version 3\n");
#else
    printf("Unknown version\n");
#endif
    return 0;
}

输出结果：

This is Version 2

这里，#if 和 #elif 检查 VERSION 的具体值，匹配到 VERSION == 2，只编译对应分支。未匹配的代码被预处理器忽略。


【实例 4】条件编译常用于编写跨平台程序。例如，根据操作系统选择代码：

#include <stdio.h>

#define OS_WINDOWS 1
// #define OS_LINUX 1

int main() {
#if defined(OS_WINDOWS)
    printf("Running on Windows\n");
#elif defined(OS_LINUX)
    printf("Running on Linux\n");
#else
    printf("Unknown OS\n");
#endif
    return 0;
}

输出结果：

Running on Windows

通过定义不同的宏（如 OS_WINDOWS 或 OS_LINUX），可以编译适合特定平台的代码。通常，这些宏由编译器或构建系统自动定义（如 _WIN32 表示 Windows）。


【实例 5】条件编译可以嵌套使用。例如，根据调试级别选择输出：

#include <stdio.h>

#define DEBUG 1
#define DEBUG_LEVEL 2

int main() {
    int x = 5, y = 10;
#if defined(DEBUG)
    printf("Debug mode enabled\n");
    #if DEBUG_LEVEL >= 1
        printf("Level 1: x = %d\n", x);
    #endif
    #if DEBUG_LEVEL >= 2
        printf("Level 2: y = %d\n", y);
    #endif
#else
    printf("Debug mode disabled\n");
#endif
    return 0;
}

输出结果：

Debug mode enabled
Level 1: x = 5
Level 2: y = 10

嵌套结构让条件编译更细粒度，但需确保每个 #if 都有对应的 #endif，否则会报错。


【实例 6】条件编译通常与 #define 配合使用。例如，在头文件中防止重复包含：

// myheader.h
#ifndef MYHEADER_H
#define MYHEADER_H

#include <stdio.h>

void sayHello() {
    printf("Hello from header!\n");
}

#endif

// main.c
#include "myheader.h"

int main() {
    sayHello();
    return 0;
}

输出结果：

Hello from header!

#ifndef MYHEADER_H 检查是否定义了 MYHEADER_H 宏，若未定义则定义并包含内容，避免头文件重复编译。

条件编译的注意事项

使用条件编译时需注意以下问题：
 

问题 说明
配对错误 #if 必须有 #endif，否则编译器报错。
未定义宏 未定义的宏在 #if 中值为 0，如 #if UNDEFINED 为假。
复杂表达式 表达式只能是常量或宏，不能包含变量或函数调用。
调试遗留 未移除的调试代码可能影响发布版本，需清理。


错误示例：

#if x > 0  // 错误：x 是变量，无法在预处理时判断
#endif

相关文章