#ifdef 与 #ifndef：宏定义检查、头文件保护、功能开关

说到 #ifdef 和 #ifndef，这俩可以说是 C 语言预处理阶段最常用的条件编译指令了。我刚开始学嵌入式那会儿，总觉得它们就是「判断宏有没有定义」这么简单。后来踩过几次坑才明白——嗯，这里面的门道其实不少。

说白了，#ifdef 检查一个宏是否被定义过，#ifndef 则检查它是否没有被定义。它们不关心宏的值是多少，只关心「有没有」这回事。你想想看，这跟 #if 指令就有本质区别了——#if 是要看值的。

基本语法与用法

#ifdef MACRO_NAME
    /* 如果 MACRO_NAME 被定义，则编译这部分代码 */
#endif

#ifndef MACRO_NAME
    /* 如果 MACRO_NAME 没有被定义，则编译这部分代码 */
#endif

我个人习惯把 #ifdef 和 #ifndef 看作「开关」和「保险丝」。开关控制功能要不要开启，保险丝防止重复包含。

三大核心应用场景

1. 头文件保护（Header Guard）

这是每个嵌入式工程师最早接触的用法。我在项目中遇到过好几次因为忘记加头文件保护导致的编译错误——那错误信息长得吓人，全是重复定义的报错。

// led_driver.h
#ifndef LED_DRIVER_H
#define LED_DRIVER_H

void led_init(void);
void led_on(void);
void led_off(void);

#endif /* LED_DRIVER_H */

为什么需要这个？因为一个头文件可能被多个源文件包含，也可能被间接包含多次。没有这个保护，编译器就会看到同一个结构体、同一个函数声明被定义了两次——直接报错。

2. 功能开关（Feature Toggle）

这是我最喜欢的用法之一。调试阶段加日志、不同硬件版本适配、功能裁剪——全靠它。

#define ENABLE_DEBUG_LOG
#define USE_NEW_ALGORITHM

void process_data(void)
{
#ifdef ENABLE_DEBUG_LOG
    printf("开始处理数据...\n");
#endif

    // 核心处理逻辑
    do_something();

#ifdef USE_NEW_ALGORITHM
    // 新算法实现
    new_algorithm();
#else
    // 旧算法实现
    old_algorithm();
#endif

#ifdef ENABLE_DEBUG_LOG
    printf("数据处理完成\n");
#endif
}

你看，只要注释掉 #define ENABLE_DEBUG_LOG 这一行，所有调试日志就全部消失了。不需要手动删代码，也不需要到处找 printf 语句。我曾经在一个项目里用这种方式管理了 20 多个功能开关，编译时通过一个配置文件就能生成不同版本的固件——省事得很。

3. 平台适配与条件编译

嵌入式开发经常要跨平台。同一套代码，可能要在 STM32、ESP32、Linux 上分别编译。这时候 #ifdef 就派上大用场了。

#ifdef STM32_PLATFORM
    #include "stm32_gpio.h"
    #define LED_PIN   GPIO_PIN_13
#elif defined(ESP32_PLATFORM)
    #include "esp32_gpio.h"
    #define LED_PIN   2
#else
    #error "未定义目标平台！"
#endif

#ifdef 与 #if defined() 的区别

写法	特点	适用场景
#ifdef MACRO	简洁，只能检查单个宏	简单的开关控制
#if defined(MACRO)	可以组合多个条件，如 #if defined(A) || defined(B)	复杂条件判断
#ifndef MACRO	检查宏是否未定义	头文件保护、默认值设置

我个人更推荐用 #if defined() 的写法，虽然多敲几个字符，但可读性和扩展性都好很多。你想想看，如果以后要加一个「或者」条件，#ifdef 就完全没法用了。

避坑指南

我曾经在一个项目里看到这样的代码：

#define DEBUG 0

#ifdef DEBUG
    printf("调试信息\n");
#endif

你觉得这段代码会打印调试信息吗？答案是——会！因为 #ifdef 只检查宏是否被定义，不管它的值是什么。哪怕 DEBUG 被定义为 0，它也是「被定义」的状态。正确的做法是用 #if DEBUG：

#define DEBUG 0

#if DEBUG
    printf("调试信息\n");
#endif

这样当 DEBUG 为 0 时，代码就不会被编译了。

知识体系图

下面这张图梳理了 #ifdef 和 #ifndef 的核心知识脉络：

总结

#ifdef 和 #ifndef 是 C 语言预处理阶段最基础也最实用的工具。头文件保护是每个项目的标配，功能开关让代码更灵活，平台适配让跨平台开发成为可能。记住一点：用 #ifdef 检查「有没有」，用 #if 检查「是多少」——搞混了这两个，调试的时候有你头疼的。

---