在 C 和 C++ 编程中，#ifndef / #define / #endif 是一种 预处理指令组合，主要用于防止头文件被重复包含，从而避免编译错误。这种机制通常被称为头文件保护符或包含防护。

作用：

当一个头文件被多次包含时，可能会导致以下问题：

1. 重复定义错误：如同一变量、函数或类型定义。

2. 编译时间延长：编译器会多次处理相同的头文件内容。

使用 #ifndef / #define / #endif 结构可以有效防止这些问题。

·  #ifndef HEADER_FILE_NAME_H：检查 HEADER_FILE_NAME_H 是否未定义。

·  #define HEADER_FILE_NAME_H：定义宏 HEADER_FILE_NAME_H，表示这个文件已经被包含。

·  #endif：结束条件。

工作原理：

· 第一次编译时：

o 宏 HEADER_FILE_NAME_H 未定义，执行 #ifndef 块中的内容。

o 定义宏 HEADER_FILE_NAME_H，然后处理文件内容。

· 后续编译时：

o 宏 HEADER_FILE_NAME_H 已定义，跳过整个 #ifndef 块，不再重复处理文件内容。

假设有头文件 example.h：

主文件 main.c：

没有防护：

· 编译器会两次处理 example.h，导致重复定义。

有防护：

· 编译器在第一次处理后定义 EXAMPLE_H，第二次直接跳过 example.h 的内容。

现代替代：#pragma once

有些编译器（如 GCC、Clang、MSVC）支持 #pragma once，可以代替 #ifndef/#define/#endif 结构，效果相同但更简洁：

但要注意，#pragma once 并非标准 C/C++，可能会存在兼容性问题。