头文件保护符是防止头文件被重复包含的预处理器机制，通过#ifndef、#define、#endif或#pragma once实现，确保头文件内容只被编译一次，避免重复定义错误。
在C++中，头文件保护符（也叫“头文件守卫”或“include防护”）是一种防止头文件被重复包含的机制。当一个头文件被多个源文件包含，或者由于复杂的包含关系被同一个文件多次包含时，如果没有保护措施，就可能导致重复定义错误。头文件保护符能有效避免这类问题。
什么是头文件保护符
头文件保护符通过预处理器指令实现，通常使用#ifndef、#define和#endif这三个宏来包裹整个头文件内容。它的作用是：第一次包含该头文件时，对应的宏未定义，于是编译器会处理文件内容并定义该宏；后续再次包含时，因为宏已定义，编译器会跳过文件内容，从而防止重复包含。
基本结构如下：
#ifndef HEADER_NAME_H #define HEADER_NAME_H // 头文件的实际内容（类声明、函数声明等） #endif // HEADER_NAME_H
其中HEADER_NAME_H是一个唯一标识符，通常根据头文件名命名，比如MYCLASS_H或VECTOR_UTILS_H，确保不会与其他头文件冲突。
立即学习“C++免费学习笔记（深入）”；
为什么需要头文件保护符
C++编译过程中，如果同一个类或函数被多次声明或定义，会导致编译错误。例如：
- 两个不同的头文件都包含了同一个公共头文件。
- 类A包含头文件X，类B也包含头文件X，而另一个文件同时包含A和B。
在这种情况下，头文件X可能被间接包含两次。如果没有保护机制，就会出现“重复定义”的编译错误。
例如，下面这种情况就会出错：
// utils.h
class MathUtils {
public:
static int add(int a, int b);
};
// file1.h
#include "utils.h"
// file2.h
#include "utils.h"
// main.cpp
#include "file1.h"
#include "file2.h" // 此时 utils.h 被包含两次
加上头文件保护符后，第二次包含会被忽略，问题得以解决。
替代方案：#pragma once
除了传统的宏守卫方式，现代C++编译器广泛支持一种更简洁的写法：
#pragma once // 头文件内容
#pragma once的作用与头文件保护符相同，但语法更简单，不易出错。只要写一次即可，无需手动定义宏名。
不过需要注意：#pragma once不是C++标准的一部分，而是编译器扩展。虽然主流编译器（如GCC、Clang、MSVC）都支持，但在极少数环境下可能存在兼容性问题。
使用建议
- 对于新项目，推荐使用#pragma once，简洁且高效。
- 若需最大兼容性或遵循严格标准，使用传统宏守卫方式。
- 宏名称应具有唯一性，常用格式为：文件名转大写 + _H，如MY_HEADER_H。
- 避免使用过于通用的宏名（如HEADER_H），以防冲突。
基本上就这些。头文件保护符虽小，却是C++工程实践中不可或缺的一环，能有效提升代码健壮性和可维护性。不复杂但容易忽略。
