使用头文件保护宏或#pragma once可防止C++头文件重复包含。前者通过#ifndef、#define和#endif定义唯一宏来避免重复编入，兼容性好；后者为编译器指令，写法简洁且高效，但非ISO标准。推荐根据项目需求选择：注重可移植性时用保护宏，现代开发中多用#pragma once。

在C++开发中，头文件被重复包含是一个常见问题。如果一个头文件被多次包含到同一个编译单元中，可能导致类、函数或变量的重复定义，从而引发编译错误。为了解决这个问题，通常有两种主流方法：使用头文件保护宏（include guards）和 #pragma once 指令。

头文件保护宏（Include Guards）

这是传统的、可移植性强的方法，通过预处理器指令防止头文件内容被多次处理。

基本写法如下：

#ifndef MY_HEADER_H
#define MY_HEADER_H

// 头文件内容
class MyClass {
    // ...
};

#endif // MY_HEADER_H

说明：

立即学习“C++免费学习笔记（深入）”；

• #ifndef 判断某个宏是否未定义。如果未定义，则继续执行下面的内容。
• #define 定义一个唯一的宏名，通常根据项目和文件命名规则来命名，避免冲突。
• 当该头文件第一次被包含时，宏未定义，因此会定义宏并包含内容；第二次及以后再包含时，宏已定义，#ifndef 条件为假，整个头文件内容被跳过。

优点：

• 兼容所有标准C++编译器。
• 符合ISO C++标准，可移植性好。

注意事项：

• 宏名称必须唯一，建议使用全大写、下划线分隔，并包含项目或文件信息，例如：GRAPHICS_CAMERA_H。
• 避免使用保留标识符（如双下划线或以_开头后接大写字母）。

#pragma once 的用法

这是一种非标准但被广泛支持的简化方式，告诉编译器只允许该头文件被包含一次。

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

#pragma once

// 头文件内容
class Utility {
    // ...
};

说明：

立即学习“C++免费学习笔记（深入）”；

• #pragma once 是编译器指令，由大多数现代编译器（如GCC、Clang、MSVC）支持。
• 无需手动定义宏，更简洁，也减少了命名冲突的风险。

优点：

• 写法简单，不易出错。
• 编译器可优化处理，有时比宏判断更快。

缺点：

• 不是C++标准的一部分，理论上存在可移植性风险（尽管实际中极少遇到不支持的情况）。
• 在某些特殊情况下（如硬链接或符号链接指向同一文件），可能判断失效。

两种方式如何选择？

目前主流做法是：

• 在个人项目或现代开发环境中，推荐使用 #pragma once，简洁清晰。
• 在需要最大可移植性或参与开源项目时，使用传统 include guards 更稳妥。
• 有些人会同时使用两者作为“双重保险”，但这通常没有必要。

示例混合写法（少见但安全）：

#pragma once
#ifndef UTILITY_H
#define UTILITY_H

// 内容

#endif

基本上就这些。无论选择哪种方式，关键是确保每个头文件都有防重包含机制。#pragma once 更现代便捷，而 include guards 更标准可靠。根据团队规范和项目需求选择即可。