26、预处理（二）：文件包含（#include）、条件编译（#if/#ifdef/#ifndef/#endif）、防止头文件重复包含
预处理指令，说白了就是编译器在正式编译之前替你干的一堆杂活。你写的代码里那些以 # 开头的行，都不是真正的 C 语句，而是给预处理器看的命令。今天咱们重点聊三个最常用的：文件包含、条件编译，以及那个让无数新手栽跟头的头文件重复包含问题。
一、文件包含：#include 的两种写法
#include 的作用很简单——把另一个文件的内容原封不动地复制到当前位置。但这里有个细节，我当年刚入行时也搞混过：尖括号和双引号到底啥区别？
| 写法 | 搜索路径 | 典型用途 |
|---|---|---|
#include <stdio.h> |
系统头文件目录（如 /usr/include） | 标准库、系统库 |
#include "myheader.h" |
先搜索当前目录，再搜索系统目录 | 用户自定义头文件 |
我个人习惯是：标准库用尖括号，自己写的用双引号。这样别人一看你的代码，就知道哪些是系统提供的，哪些是你自己造的。
二、条件编译：让代码“见风使舵”
条件编译就是让预处理器根据某些条件，决定哪些代码保留、哪些代码扔掉。这玩意儿在跨平台开发中简直是神器。
2.1 #if / #elif / #else / #endif
这组指令跟普通的 if-else 很像，但注意：条件必须是常量表达式，不能是变量。为什么？因为预处理器在编译之前就执行了，那时候变量还不存在呢。
#define PLATFORM 2
#if PLATFORM == 1
printf("Running on Platform 1\n");
#elif PLATFORM == 2
printf("Running on Platform 2\n");
#else
printf("Unknown platform\n");
#endif我在项目中遇到过这样的情况：同一套代码要跑在 Windows 和 Linux 上。文件路径的写法不一样，线程库的 API 也不一样。用条件编译，一套代码搞定两个平台，省心不少。
2.2 #ifdef / #ifndef
#ifdef 检查某个宏是否被定义过，#ifndef 则相反。这两个用得比 #if 更频繁，因为很多时候你只是想知道“这个宏有没有定义”，而不关心它的值是多少。
#ifdef DEBUG
printf("Debug mode: x = %d\n", x);
#endif你想想看，调试的时候加上 #define DEBUG，发布的时候注释掉，所有调试输出就自动消失了。不用手动删代码，也不用担心删漏了。
#ifdef 和 #if defined() 效果一样，但后者可以组合多个条件，比如 #if defined(A) && !defined(B)。我个人更推荐用 #if defined()，因为更灵活。
三、防止头文件重复包含
这是新手最容易踩的坑。假设你有三个文件：a.h 定义了一个结构体，b.h 和 c.h 都包含了 a.h，然后 main.c 又同时包含了 b.h 和 c.h。结果呢？结构体被定义了两次，编译器直接报错。
解决方案有两种，我分别说说。
3.1 宏守卫（Include Guard）—— 最传统的方式
#ifndef MYHEADER_H
#define MYHEADER_H
// 头文件内容写在这里
#endif /* MYHEADER_H */原理很简单：第一次包含时，MYHEADER_H 没定义，所以进入 #ifndef 内部，然后定义了这个宏。第二次再包含时，宏已经定义了，整个内容被跳过。
我曾经见过有人把宏名字写得很随意，比如 _H_ 或者 HEADER，结果跟别的头文件冲突了。嗯，这里要注意：宏名字最好跟文件名相关，比如 MYHEADER_H，这样基本不会重名。
3.2 #pragma once —— 现代编译器的偷懒写法
#pragma once
// 头文件内容写在这里一行搞定，编译器自己会记住这个文件只包含一次。大多数主流编译器（GCC、Clang、MSVC）都支持。但有个小问题：如果同一个文件通过不同路径被包含（比如软链接），#pragma once 可能失效。不过实际项目中很少遇到这种情况。
#pragma once，简洁明了。老项目或者需要最大可移植性的项目，用传统的宏守卫。两种都行，别纠结。
四、知识体系一览
下面这张图把今天讲的内容串起来了，你可以看到预处理指令在整个编译流程中的位置，以及它们之间的逻辑关系。
五、避坑指南
最后分享几个我踩过的坑，希望能帮你省点调试时间。
- 宏名字冲突：我曾经用
_HEADER_H做守卫宏，结果跟某个系统头文件冲突了，编译报错找了半天。后来我统一用项目名_文件名_H的格式，再也没出过问题。 - 条件编译里的语法错误：预处理器只是简单地复制粘贴，它不会检查 C 语法。如果你在
#if 0里写了一段代码，预处理器直接把它扔掉，编译器根本看不到。但如果你忘了写#endif，那后面的所有代码都会被吞掉，编译报错会非常诡异。 - 头文件互相包含：a.h 包含 b.h，b.h 又包含 a.h。如果没有守卫宏，预处理器会无限递归下去，直到编译器报错。有了守卫宏，虽然不会无限递归，但可能会导致某个结构体在另一个头文件里还没定义就被使用了。这种问题很难排查，我的经验是：尽量让头文件之间的依赖关系是单向的，不要搞循环依赖。
好了，预处理这部分就聊到这儿。记住一句话：预处理器是你的好帮手，但用不好也能让你头疼半天。多写、多试、多踩坑，慢慢就熟练了。