c++中防止头文件重复包含的机制叫“头文件保护”或“包含守卫”，通过#ifndef/#define/#endif组合实现：首次包含时定义宏并编译内容，再次包含时跳过全部内容；规范宏名应全大写加下划线且全局唯一，如STRING_UTILS_H；现代替代方案#pragma once更简洁但属非标准扩展。
这是C++中防止头文件被多次包含的常用机制，叫“头文件保护”或“包含守卫”（include guard）。
为什么需要#ifndef/#define/#endif？
当多个源文件或头文件都#include同一个头文件，或者头文件之间相互包含时，可能造成同一个头文件内容被编译器读入多次。这会导致重复定义（比如类、函数声明、宏等），引发编译错误。
例如：test.h 被 a.cpp 和 b.cpp 同时包含；而 a.cpp 还包含了 common.h，后者又 #include 了 test.h —— 这样 test.h 就可能被间接包含两次。
它们是怎么配合工作的？
三者组成一个逻辑判断：
立即学习“C++免费学习笔记（深入）”；
- #ifndef MY_HEADER_H：检查宏 MY_HEADER_H 是否尚未定义
- #define MY_HEADER_H：如果没定义过，就定义它（仅第一次包含时执行）
- #endif：结束条件编译块
第二次再遇到这个头文件时，MY_HEADER_H 已存在，#ifndef 判断为假，中间所有内容（包括声明、定义等）直接被跳过，不参与编译。
怎么写才规范？
宏名建议用全大写+下划线，确保全局唯一。常见写法有：
- 文件名大写+下划线+后缀，如 #define STRING_UTILS_H（对应 string_utils.h）
- 加项目前缀避免冲突，如 #define MYPROJ_CONFIG_H
- 不要用简单名字如 #define HEADER —— 极易重名
注意：宏名不能含点号、连字符等非法字符，LOG.H 对应的宏应写作 LOG_H，而非 LOG.H。
现代替代方案：#pragma once
很多编译器（GCC、Clang、MSVC）支持更简洁的写法：
#pragma once
它语义明确、不易出错、书写简单，但属于非标准扩展（C++标准未强制要求）。大型跨平台项目中，仍推荐优先用 #ifndef 方式以保证最大兼容性；个人项目或内部代码可用 #pragma once 提高可读性。