C++预处理指令ifndef define endif_C++头文件包含卫士写法

使用#ifndef、#define和#endif定义头文件包含卫士可防止重复包含，如#ifndef VECTOR_H #define VECTOR_H ... #endif，确保头文件内容只被编译一次，避免重复定义错误。

在C++中，为了避免头文件被多次包含导致重复定义错误，通常使用预处理指令来设置“头文件包含卫士”（Include Guard）。这种机制通过#ifndef、#define和#endif配合实现，确保头文件内容只被编译一次。

头文件包含卫士的基本写法

标准的包含卫士结构如下：

#ifndef HEADER_NAME_H
#define HEADER_NAME_H

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

#endif // HEADER_NAME_H

说明：

• #ifndef HEADER_NAME_H：判断是否已定义宏HEADER_NAME_H。如果没有定义，则继续执行下面的代码。
• #define HEADER_NAME_H：定义一个唯一的宏名，标记该头文件已被包含。
• #endif：结束条件编译块。

宏命名建议

宏名称应具有唯一性，避免与其他头文件冲突。常见命名方式包括：

• 使用头文件全大写路径名，如：#ifndef MYPROJECT_MATH_UTILS_H
• 加上项目前缀或时间戳防止重名，如：#ifndef MATH_UTILS_V1_2025_H
• 部分编译器支持#pragma once，但它是非标准扩展，可读性强但兼容性略差。

实际例子

假设有一个名为vector.h的头文件：

#ifndef VECTOR_H
#define VECTOR_H

class Vector {
public:
    Vector(int x, int y);
    int getX() const;
    int getY() const;

private:
    int x_, y_;
};

#endif // VECTOR_H

这样即使在多个源文件或嵌套包含中#include "vector.h"，也不会引发重复定义问题。

基本上就这些，正确使用#ifndef、#define、#endif能有效防止头文件重复包含，是C++工程中的基础实践。不复杂但容易忽略。