包含保护
防止重复包含。
包含保护 是 CoddyKit 上的免费 C Academy 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 C Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 C Academy 课程共包含 4 节课。
重复包含问题
头文件经常会包含其他头文件，因此一个头文件很容易在同一个源文件中被包含两次。
发生这种情况时，其中的每个声明都会出现两次。对于 struct 或 typedef 这样的类型定义，这会导致编译错误：同一种类型不能被定义多次。
它是如何悄悄发生的
假设 a.h 和 b.h 都包含 types.h。同时包含这两个头文件的源文件最终会将 types.h 粘贴两次。
预处理器会不加判断地复制头文件文本，因此 types.h 中的定义会重复，从而触发重复定义错误。
/* a.h */ #include "types.h"
/* b.h */ #include "types.h"
/* main.c */
#include "a.h"
#include "b.h" /* types.h now seen twice */包含保护
包含保护是一种简单的预处理器技巧，可以让头文件安全地被包含多次。
它会将整个头文件包在一个条件中，使主体内容只在第一次被处理。之后的包含会被完全跳过。
#ifndef TYPES_H
#define TYPES_H
/* header contents here */
#endif /* TYPES_H */保护机制的工作原理
第一次看到该头文件时，TYPES_H 尚未定义，因此 #ifndef 条件为真，主体内容会被处理。随后，#define 会设置这个宏。
之后再次包含时，TYPES_H 已经存在，因此 #ifndef 条件为假，预处理器会跳到 #endif。
#ifndef TYPES_H /* true only the first time */
#define TYPES_H /* remember we've been here */
/* ... body ... */
#endif完整的受保护头文件
这里是一个真实示例，其中使用保护机制保护类型定义。
即使许多文件直接或间接包含 point.h，Point 结构体在每个翻译单元中也只会被定义一次。
/* point.h */
#ifndef POINT_H
#define POINT_H
typedef struct {
int x;
int y;
} Point;
Point point_add(Point a, Point b);
#endif选择宏名称
保护宏必须在整个项目中保持唯一，否则两个头文件可能发生冲突，并悄悄地相互隐藏。
一种常见惯例是根据文件名生成大写名称：point.h 变为 POINT_H，net/socket.h 变为 NET_SOCKET_H。
#ifndef NET_SOCKET_H
#define NET_SOCKET_H
/* ... */
#endif避免使用保留名称
以下划线和大写字母开头，或包含双下划线的标识符，是为编译器和标准库保留的。
请避免使用 __POINT_H__ 这样的保护宏。像 POINT_H 这样的普通末尾形式既安全又清晰。
#ifndef _POINT_H_ /* risky: reserved name pattern */
#ifndef POINT_H /* preferred */#pragma once 替代方案
大多数现代编译器都支持 #pragma once。只需在头文件顶部添加这一行，就能实现相同的功能。
它更简短，也能避免名称冲突，但并不属于 C 标准。传统的 #ifndef 保护机制可以在任何地方使用。
/* point.h */
#pragma once
typedef struct { int x; int y; } Point;保护机制与 Pragma
#ifndef 保护机制完全可移植且符合标准，但要求每个头文件使用唯一的宏。
#pragma once 简洁且不会发生冲突，但依赖编译器支持。有些项目会同时使用两者：使用 pragma，再加上经典保护机制，以获得最大程度的安全性。
#pragma once
#ifndef POINT_H
#define POINT_H
/* ... */
#endif保护机制针对每个翻译单元
包含保护可以防止同一个源文件在编译过程中重复包含头文件。
它不会阻止头文件在每个独立的 .c 文件中各自被处理一次。这没有问题，因为每个源文件都是一个独立的翻译单元。
养成习惯
请从第一行开始，就为您编写的每个头文件添加包含保护。它只需三行代码，却可以防止一大类令人困惑的错误。
即使是简单的头文件，今后也可能通过其他头文件被间接包含，因此从一开始就添加保护可以省去许多麻烦。
/* config.h */
#ifndef CONFIG_H
#define CONFIG_H
#define MAX_USERS 100
#endif快速检查
检查您对包含保护的掌握情况。
回顾
您已经了解了重复包含头文件会导致重复定义错误，也学会了如何使用包含保护来避免这种问题。
请使用 #ifndef/#define/#endif 和唯一的宏，或使用 #pragma once。接下来，我们将学习如何使用 extern 在多个文件之间共享变量。
常见问题解答
「包含保护」课时是免费的吗？
是的 — 「包含保护」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 C Academy 课程的其余内容，请升级到 CoddyKit PRO。 C Academy 课程共包含 4 节课。
「包含保护」这节课中我会学到什么？
防止重复包含。 你通过在浏览器中直接运行的动手代码来练习 C Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 C Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 C Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。
「包含保护」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 C Academy 课中编写并运行代码吗？
能。每节 C Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。