头文件守卫通过#ifndef、#define、#endif防止重复包含，确保类或函数不被重复定义，避免编译错误；例如多次引入common.h时，宏MYCLASS_H保证内容只处理一次；#pragma once是更简洁的替代方案，但跨平台项目推荐使用宏守卫以确保兼容性。

在C++中，头文件的重复包含是一个常见问题。如果同一个头文件被多次引入到一个编译单元中，可能会导致重复定义错误，比如类、函数或变量被定义多次。为避免这类问题，通常使用 #ifndef、#define 和 #endif 配合构成“头文件守卫”（Header Guard）机制。

头文件守卫的基本结构

典型的头文件守卫写法如下：

#ifndef MYCLASS_H
#define MYCLASS_H

// 头文件内容：类声明、函数声明等

#endif // MYCLASS_H

这段代码的作用是：当预处理器第一次处理该头文件时，宏 MYCLASS_H 尚未定义，因此 #ifndef 条件成立，接着通过 #define 定义该宏，并包含头文件的实际内容。之后若再次包含此文件，#ifndef 检查发现宏已定义，跳过整个头文件内容，从而防止重复包含。

为什么需要防止重复包含

C++编译过程中，每个源文件（.cpp）会被独立编译成目标文件。如果多个头文件相互包含，或者某个头文件被多个地方引用，很容易造成同一头文件被间接包含多次。例如：

• fileA.h 包含 common.h
• fileB.h 也包含 common.h
• main.cpp 同时包含 fileA.h 和 fileB.h

此时，common.h 会被实际引入两次。如果没有头文件守卫，其中的类定义就会报错：“redefinition of class”。而头文件守卫能确保内容只被处理一次。

替代方案：#pragma once

现代编译器普遍支持另一种更简洁的方式：#pragma once。它实现相同功能，但语法更简单：

#pragma once

// 头文件内容

#pragma once 的优点是无需手动命名宏，避免命名冲突，且更直观。但它不是C++标准的一部分（尽管广泛支持），在极少数编译器或特殊环境下可能不可靠。因此，在跨平台或高兼容性要求的项目中，仍推荐使用传统的宏守卫方式。

注意事项与最佳实践

使用宏守卫时需注意以下几点：

• 宏名称必须唯一，通常采用 “文件名全大写 + _H” 的格式，如 MYVECTOR_H
• 避免使用可能与其他头文件冲突的通用名，如 HEADER_H
• 宏名不能与系统或其他库的宏重复
• 虽然 #pragma once 更方便，但在追求最大可移植性的项目中建议坚持使用 #ifndef 方式

基本上就这些。头文件守卫看似简单，却是C++项目稳定构建的基础机制之一，理解其原理有助于写出更健壮的代码。不复杂但容易忽略细节。