头文件重复包含是指在多个源文件中直接或间接包含同一个头文件，导致声明重复。解决方法有两种：1. 使用宏保护（#ifndef/#define/#endif），通过唯一宏名确保头文件内容只被编译一次；2. 使用#pragma once，写法简单但兼容性略差。编写时应注意宏名唯一、减少头文件依赖、实现放在.cpp中、避免在头文件定义变量和函数体。例如math_utils.h用宏保护声明函数add，对应.cpp实现，可防止重复定义错误。
在写C++程序的时候，头文件的重复包含是个常见问题。如果不处理好，编译器会报错，说某个类或者函数被多次定义。解决这个问题的关键，就是用预处理指令防止头文件被重复包含。
什么是头文件重复包含？
简单来说，就是在多个源文件中包含了同一个头文件，或者一个头文件被其他头文件多次间接包含。比如：
a.h
包含了b.h
main.cpp
同时包含了a.h
和b.h
这时候，
b.h就会被包含两次，里面的声明就会出现重复，导致编译错误。
立即学习“C++免费学习笔记（深入）”；
常用的防止重复包含方式
C++中常用的方式有两种：一种是使用
#ifndef / #define / #endif，另一种是使用
#pragma once。
1. 使用宏保护（#ifndef）
这是最传统、兼容性最好的方法。基本结构如下：
#ifndef MY_HEADER_H #define MY_HEADER_H // 头文件内容放在这里 #endif // MY_HEADER_H
这里的宏名建议唯一，通常可以按文件路径来命名，比如
PROJECT_UTILS_MATH_H这样的格式，避免与其他头文件冲突。
2. 使用 #pragma once
这是一种更简洁的方式：
#pragma once // 头文件内容
优点是写法简单，但缺点是并非所有编译器都支持（虽然主流现代编译器如 MSVC、GCC、Clang 都支持）。如果你需要跨平台兼容性特别强，还是推荐用宏保护。
实际编写中的注意事项
-
宏名要唯一：尽量用项目名+路径+文件名组合成宏名，例如
MYAPP_CORE_CONFIG_H
。 - 不要嵌套太深的头文件依赖：这样容易造成循环依赖或难以维护的问题。
-
优先把实现放在
.cpp
文件中：头文件只放声明，减少重复包含带来的影响。 - 避免在头文件里直接定义变量和函数体（除非是 inline）：否则多个包含会导致多重定义错误。
简单例子说明
比如我们有一个
math_utils.h头文件，里面声明了一个加法函数：
#ifndef MATH_UTILS_H #define MATH_UTILS_H int add(int a, int b); #endif // MATH_UTILS_H
对应的
math_utils.cpp文件实现它：
#include "math_utils.h"
int add(int a, int b) {
return a + b;
}这样无论你在多少个
.cpp文件里
#include "math_utils.h"，都不会出问题。
基本上就这些。写头文件的时候多注意一下宏保护和依赖关系，就能避免大部分重复包含的问题了。
