4、条件编译进阶：defined() 运算符、条件编译的嵌套、头文件保护符

好，咱们继续往下聊。上一节我们把 #ifdef、#ifndef、#if 这些基础用法捋了一遍。说实话，那些东西应付日常开发基本够了。但你要是想写出真正健壮、可移植的代码，光靠那三板斧可不行。

这一节，我带你看看条件编译里几个「进阶但极其常用」的技巧。我个人习惯把它们称为「嵌入式老司机的必修课」——defined() 运算符、条件编译的嵌套、还有头文件保护符。

4.1 defined() 运算符：更灵活的判断

先问个问题：#ifdef 和 #if defined() 有什么区别？

嗯，其实功能上差不多。但 defined() 有一个杀手锏——它可以跟逻辑运算符组合使用。

举个例子。我在项目中遇到过这样一个场景：某个功能需要同时开启 FEATURE_A 和 FEATURE_B 两个宏才能启用。用 #ifdef 你得写两层嵌套：

#ifdef FEATURE_A
  #ifdef FEATURE_B
    // 启用功能
  #endif
#endif

看着就烦，对吧？用 defined() 一行搞定：

#if defined(FEATURE_A) && defined(FEATURE_B)
    // 启用功能
#endif

清爽多了。你还可以用 ||（或）、!（非）来组合判断：

#if defined(DEBUG) || defined(TEST_MODE)
    printf("调试信息输出\n");
#endif

#if defined(USE_FPU) && !defined(SOFT_FLOAT)
    // 使用硬件浮点
#endif

我的小习惯：只要涉及多个宏的组合判断，我首选 defined()。它让代码更扁平，可读性更好。单宏判断的话，#ifdef 更简洁，看个人喜好。

4.2 条件编译的嵌套：层层递进

条件编译可以嵌套，这没什么稀奇的。但嵌套多了，代码就变成了「意大利面条」。我曾经接手过一个项目，一个文件里嵌套了七八层 #if，看得我头皮发麻。

怎么避免？记住一个原则：嵌套不超过三层。超过三层，就该考虑重构了。

来看一个合理的嵌套例子：

#if defined(PLATFORM_STM32)
    #if defined(USE_HAL_DRIVER)
        #include "stm32_hal.h"
    #else
        #include "stm32_ll.h"
    #endif
#elif defined(PLATFORM_ESP32)
    #include "esp_system.h"
#else
    #error "Unsupported platform!"
#endif

这个结构很清晰：先判断平台，再判断驱动层。两层嵌套，一目了然。

注意：嵌套时一定要对齐缩进。我见过有人不缩进，结果 #endif 跟哪个 #if 配对都分不清。建议用编辑器自动格式化，或者手动保持 2-4 空格的缩进。

4.3 头文件保护符：#pragma once vs #ifndef

这是每个 C 程序员都绕不开的话题。头文件保护符，说白了就是防止同一个头文件被重复包含。

两种主流写法：

写法一：传统 #ifndef

#ifndef __MY_HEADER_H__
#define __MY_HEADER_H__

// 头文件内容

#endif /* __MY_HEADER_H__ */

写法二：现代 #pragma once

#pragma once

// 头文件内容

哪个更好？我直接说结论：

特性	#ifndef	#pragma once
兼容性	所有 C/C++ 编译器	主流编译器都支持（GCC、Clang、MSVC、IAR、Keil）
代码量	3 行（#ifndef、#define、#endif）	1 行
防重名	需要手动保证宏名唯一	编译器自动处理，不会冲突
编译速度	稍慢（需要打开文件读取宏）	稍快（编译器直接标记）

  我的建议：新项目直接用 #pragma once。省事、干净、不容易出错。但如果你在维护老项目，或者需要兼容某些上古编译器（比如一些 8051 的编译器），那就老老实实用 #ifndef。

我曾经在一个跨平台项目里吃过亏。当时用了 #pragma once，结果某个编译器不支持，编译报错。排查了半天才发现是头文件保护符的问题。从那以后，我在需要高度可移植的代码里，还是用 #ifndef。

不过话说回来，现在 99% 的嵌入式编译器都支持 #pragma once 了。你大可放心使用。

4.4 知识体系总览

下面这张图，帮你把这一节的核心逻辑串起来：

4.5 避坑指南

最后，分享几个我踩过的坑：

宏名重复：用 #ifndef 时，宏名一定要够长、够唯一。我见过有人用 _H_ 这种名字，结果两个头文件冲突了，编译报错找半天。建议用 __模块名_文件名_H__ 这种格式。
defined() 的括号：#if defined MACRO 这样写虽然也能编译，但可读性差。我建议始终加括号：#if defined(MACRO)。
嵌套太深：我曾经在一个项目里看到 7 层嵌套的 #if，最后连原作者都搞不清逻辑了。记住，嵌套超过 3 层，就该用函数指针或者配置文件来替代了。

好了，这一节的内容就这些。条件编译的进阶用法，说白了就是让你写代码更灵活、更安全。多练练，你也能写出漂亮的预处理代码。

可可精品资料库

📚 课程目录

4、条件编译进阶：defined() 运算符、条件编译的嵌套、头文件保护符

4.1 defined() 运算符：更灵活的判断

4.2 条件编译的嵌套：层层递进

4.3 头文件保护符：#pragma once vs #ifndef

4.4 知识体系总览

4.5 避坑指南