编译时如何强制禁止包含使用#pragma once的指定头文件？

以下是几种能在编译阶段强制禁止源文件包含指定头文件的方法，适配目标头文件使用#pragma once而非传统头文件守卫的场景：

1. 同名类重定义拦截（你的方案优化） #

既然要避免依赖目标头文件里的类，直接在源文件最顶部（所有#include之前）定义与目标类完全同名（含命名空间）的类/结构体。一旦后续代码（或间接依赖）意外包含目标头文件，编译器会立刻抛出类重定义错误，精准定位问题。

示例代码：

// 假设目标头文件里的类是 some_namespace::BannedClass
namespace some_namespace {
// 直接定义空类即可触发重定义
class BannedClass {};
}

// 后续如果意外包含目标头文件，编译报错："BannedClass" 重定义

2. 编译器内置拦截特性 #

不同编译器提供了直接禁止包含指定头文件的特性，无需修改业务代码：

• GCC/Clang：用#pragma GCC poison标记禁止的头文件，配合-include参数强制全局包含检查头文件：
  1. 新建banned_check.h：

     #pragma GCC poison "banned_header.h"
     

  2. 编译时添加参数：-include banned_check.h，任何包含banned_header.h的代码都会触发编译错误。
• MSVC：用__pragma(poison)实现类似效果，配合/FI参数：
  1. 新建banned_check.h：

     __pragma(poison "banned_header.h")
     

  2. 编译时添加参数：/FI banned_check.h，拦截所有对目标头文件的包含。

3. 预编译脚本扫描（构建系统集成） #

在CMake、Makefile等构建流程中加入预检查步骤，用脚本扫描所有源文件及依赖头文件，发现包含禁止头文件就终止构建：

# Makefile 示例检查规则
check_banned_headers:
    grep -r "#include.*banned_header.h" ./src/ && echo "错误：发现禁止包含的头文件！" && exit 1

这种方法能在编译前就拦截问题，适合批量检查整个项目。

4. 预编译宏触发错误（针对间接包含场景） #

如果无法修改目标头文件，可在源文件开头主动尝试包含目标头文件，结合static_assert触发错误——如果目标头文件已经被间接包含过，#pragma once会阻止重复包含，此时我们可以通过自定义宏来检测：

// 源文件最顶部
#define CHECK_BANNED_INCLUDE
#include "banned_header.h"
#ifdef CHECK_BANNED_INCLUDE
static_assert(false, "禁止包含该头文件！");
#endif

原理：如果目标头文件未被包含过，主动包含后CHECK_BANNED_INCLUDE会被保留（假设目标头文件里没定义这个宏），触发static_assert；如果已经被间接包含，#pragma once会跳过主动包含，同样触发断言。

内容的提问来源于stack exchange，提问作者DXZ