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 就可能被间接包含两次。

它们是怎么配合工作的？

三者组成一个逻辑判断：

• #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 提高可读性。

# c++  # 编译错误  # 为什么  # define  # include  # 头文件  # 下划线  # 跳过  # 非标准  # 这是  # 首次  # 多个  # 是怎么  # 两次  # 而非 

相关文章： c++如何实现简单的DNS域名解析_c++ getaddrinfo函数与IP地址转换【方法】  Windows10如何删除Windows.old_Win10磁盘清理系统文件选项  如何使用 jQuery 正确渲染 Instagram 风格的标签列表  1688铺货到淘宝怎么操作 1688一键铺货到自己店铺详细步骤  曝iQOO 15 Ultra确定在春节前登场 搭载主动散热系统  解决 Telegram Web View 在 iOS 中软键盘遮挡输入框的问题  批改网怎么提交作文 批改网学生端上传文章详细步骤  洁耳护耳双专家，家里人人都好用——蜂鸟bebird专业耳朵护理仪重磅上市！  米侠浏览器网页图片不显示怎么办 米侠图片加载修复  浏览器地址栏搜索建议怎么关闭_禁用Chrome的搜索和网址建议【隐私】  Java中的Collectors类有哪些常用功能_Collectors聚合操作解析  新兴技术如何推动数据中心与工业领域的余热再利用？  以“洁净”温暖童年，用“科技”照亮未来——海信洗衣机爱心进驻九江太阳村  腾讯混元开源 HY-Motion1.0，10 亿参数文生 3D 动作大模型  苏州：推广人工智能应用场景，对获国家支持的示范项目最高奖励 1000 万元  如何用C++编写Windows服务？C++后台服务程序开发教程【系统编程】  如何在Magento 2项目中通过Composer管理扩展？（命令行指南）  Edge浏览器怎么启用睡眠标签页_节省电脑内存占用优化技巧  Boss直聘怎么查看谁看过我 Boss直聘查看谁看过我方法【教程】  C++如何使用std::bind和占位符？（函数封装）  铁锤守卫英雄传2测评：优点和缺点都非常鲜明  Midjourney怎么改色彩饱和度_Midjourney色彩调整教程【指南】  如何在 PHP DOM 中正确提取 CDATA 内容（如 lastmod 值）  PHP怎么接收嵌套数组参数_处理多维数组数据接收教程【汇总】  Python面向对象测试方法_mock解析【教程】  PHP 实现电台节目单的智能时间匹配与动态展示  html5表单datalist标签怎么用_输入框下拉建议列表设置技巧【教程】  Java面向对象设计中责任如何划分_Java类职责拆分原则解析  HTML5打空格有哪些误区_新手常犯的空格使用错误【技巧】  Owlcat官宣推出自家启动器 玩家社区炸锅：不需要！ 

相关栏目： 【 行业资讯17850 】 【 软件资源51899 】 【 网站技术89748 】 【 百度推广44206 】 【 网络营销84187 】 【 运营推广93002 】 【 AI优化91086 】 【 网络优化117696 】 【 网址导航107142 】