在 C++ 中，如果一个头文件被多次包含（例如，多个源文件都包含了同一个头文件），可能会导致重复定义错误。头文件保护宏的作用就是确保头文件的内容只被编译一次，避免重复定义。

头文件保护宏通常使用以下格式：
 

#ifndef MACRO_NAME
#define MACRO_NAME

// 头文件的内容

#endif // MACRO_NAME

#ifndef:即if not define.如果未定义某个宏，则执行后续代码

#endif:结束条件编译

看个例子：
 

#ifndef EXAMPLE_H
#define EXAMPLE_H

class Example 
{
private:
    static int staticVar; // 静态成员变量

public:
    static void staticFunction(); // 静态成员函数
};

#endif // EXAMPLE_H

工作原理

1. 当编译器第一次遇到#ifndef EXAMPLE_H时，它会检查EXAMPLE_H是否已经定义。

   • 如果未定义，则继续执行后续代码。

   • 如果已定义，则跳过整个头文件的内容。

2. 在第一次包含头文件时，#define EXAMPLE_H会定义EXAMPLE_H宏。

3. 如果头文件被再次包含,#ifndef EXAMPLE_H会发现EXAMPLE_H已经定义，因此会跳过整个头文件的内容，避免重复定义。

为什么需要头文件保护宏？

如果没有头文件保护宏，编译器会两次包含 Example.h 的内容，导致 class Example 被重复定义，从而引发编译错误。

头文件保护宏的命名规则

头文件保护宏的名称通常是头文件名的全大写形式，并用下划线 _ 替换点 . 和其他特殊字符。例如：

• example.h的头文件保护宏可以是EXAMPLE_H。

• myclass.h的头文件保护宏可以是MYCLASS_H。

现代替代方案：#pragma once

除了头文件保护宏，现代编译器还支持#pragma once，它的作用与头文件保护宏相同，但更简洁。

#pragma once

class Example 
{
private:
    static int staticVar; // 静态成员变量

public:
    static void staticFunction(); // 静态成员函数
};

#pragma once 的优点

• 更简洁，不需要手动定义宏。

• 避免了宏名称冲突的可能性。

#pragma once 的缺点

• 不是 C++ 标准的一部分（尽管大多数现代编译器都支持）。

• 在某些较旧的编译器上可能不支持。