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