条件编译：开启高效编程的钥匙，远离低效陷阱

前言

• 在刚接触嵌入式C语言时，总是不理解为什么在创建头文件的时候要添加条件编译，总感觉自己写过的编译条件自己会不记得吗，添加条件编译是不是多此一举。尽管那些大神不断的解释，但基本上都是在本身就会的角度在解释，对小白的我就好像对牛弹琴，还隔着道门的感觉。
• 直到有一次，忘记从那本书上看到的解释，加上自己实操以后，一下子开窍了一样。在这里就根据自己的理解，将其记录下来，希望能帮助到和我曾经一样迷茫的小伙伴。

一、避免重复定义

在多个源文件包含同一个头文件时，如果没有条件编译，头文件中的定义（如宏定义、函数声明、结构体定义等）会被多次重复定义。
例如，如果一个头文件中定义了一个全局宏 #define MAX_VALUE 100 ，多个源文件包含这个头文件时，就会多次定义 MAX_VALUE，这在编译时会导致错误。
使用条件编译，如 #ifndef HEADER_FILE_NAME_H、#define HEADER_FILE_NAME_H 和 #endif 包裹头文件内容，可以确保头文件内容只被编译一次，提高编译效率。
不使用条件编译时，编译器会对重复定义的内容进行多次处理，增加编译时间。而条件编译能避免不必要的编译过程，尤其是在大型项目中，包含众多源文件和头文件时，能显著提高编译效率。
便于代码维护和移植
对于可移植的代码，在不同的编译环境或者项目配置下，可能需要有选择地包含头文件中的部分内容。条件编译提供了一种方便的方式来实现这种选择性编译，而不使用条件编译则很难做到这一点。

二、使用格式注意事项

1. 宏定义的唯一性

一般按照约定俗成的方式定义宏来防止头文件被多次包含，例如#ifndef HEADER_FILE_NAME_H，其中_HEADER_FILE_NAME_H_是根据头文件名称转换而来的，通常将头文件名称中的点（.）转换为下划线（_），并且全部大写。

2. 正确的嵌套关系

如果在条件编译块中有多层嵌套，要确保逻辑正确。例如，在头文件中可能存在基于不同编译条件的代码块嵌套，要保证#ifndef、#ifdef、#elif和#endif等的正确配对，避免编译错误。

3. 代码可读性

条件编译中的条件判断尽量简单明了，不要过于复杂的逻辑表达式。并且可以适当添加注释来解释条件编译的目的，以便于代码的维护和阅读。

三、举例说明

以下是一个使用 Keil5 编写头文件时条件编译的例子：
假设我们有一个名为myheader.h的头文件。

1. 正确使用条件编译的示例

#ifndef _MYHEADER_H_
#define _MYHEADER_H_

// 这里可以定义宏
#define MY_CONSTANT 10

// 函数声明
int myFunction(int a, int b);

// 结构体定义
typedef struct {
    int data;
    char name[20];
} MyStruct;

#endif

在这个例子中，#ifndef MYHEADER_H 检查是否已经定义了 MYHEADER_H 这个宏。如果没有定义，就通过 #define MYHEADER_H 定义它，然后编译头文件中的内容（宏定义、函数声明和结构体定义等）。当其他源文件再次包含myheader.h时，由于 MYHEADER_H 已经被定义，头文件中的内容就不会被再次编译，从而避免了重复定义的错误。

2. 不使用条件编译可能出现的问题示例

假设没有条件编译，有两个源文件main.c和other.c都包含myheader.h，且myheader.h中有如下内容：

// 没有条件编译的错误示例
// 宏定义
#define MY_CONSTANT 10

// 函数声明
int myFunction(int a, int b);

// 结构体定义
typedef struct {
    int data;
    char name[20];
} MyStruct;

当编译main.c时，这些定义会被编译。当编译other.c时，同样的定义又会被编译一次，这就会导致编译错误，因为 MY_CONSTANT 被重复定义了，MyStruct结构体也被重复定义等。