如何在编译期禁止开发者在.h文件中引入BigHeader.h

下面提供两种无需外部脚本、仅通过修改BigHeader.h即可实现的编译期/预处理限制方案，适配你的需求：

方案一：利用包含层级宏自动检测 #

通过编译器预定义的__INCLUDE_LEVEL__宏判断BigHeader.h的包含上下文：

• __INCLUDE_LEVEL__为0对应当前编译的主源文件
• 被源文件直接包含时，BigHeader.h的__INCLUDE_LEVEL__为1
• 被头文件间接/直接包含时，__INCLUDE_LEVEL__会大于1

在BigHeader.h的头部添加以下代码：

#ifndef BIG_HEADER_H_
#define BIG_HEADER_H_

// 禁止在头文件中（直接或间接）引入BigHeader.h
#if __INCLUDE_LEVEL__ > 1
#error "禁止在头文件中引入BigHeader.h，请使用BigHeaderFwd.h替代"
#endif

// --------------------------
// 原BigHeader.h的内容开始
// --------------------------

#endif // BIG_HEADER_H_

优点：无需开发者额外操作，自动生效；能同时拦截直接和间接的头文件包含行为。
局限性：依赖编译器对__INCLUDE_LEVEL__的支持（GCC、Clang、MSVC均原生支持该宏）。

方案二：显式宏授权机制 #

要求只有源文件能通过定义特定宏来引入BigHeader.h，头文件因未定义授权宏会触发编译错误。

在BigHeader.h的头部添加：

#ifndef BIG_HEADER_H_
#define BIG_HEADER_H_

// 仅允许定义了BIG_HEADER_SOURCE_FILE的文件包含当前头
#ifndef BIG_HEADER_SOURCE_FILE
#error "请在源文件中先定义BIG_HEADER_SOURCE_FILE再引入BigHeader.h，头文件请使用BigHeaderFwd.h"
#endif

// --------------------------
// 原BigHeader.h的内容开始
// --------------------------

#endif // BIG_HEADER_H_

开发者在需要使用BigHeader.h的.cpp文件中需先定义宏再引入：

// 示例源文件：SomeRandomFile.cpp
#define BIG_HEADER_SOURCE_FILE
#include "BigHeader.h"
#include "SomeRandomFile.h"

// 使用BigHeader.h中的类型
void func(BigType* obj) {
    // ...
}

优点：规则明确，便于开发者理解；能精准控制哪些文件可以引入BigHeader.h。
局限性：需要开发者在源文件中手动添加宏定义，存在少量额外操作成本。

补充说明 #

两种方案均无需外部脚本，完全通过预处理指令实现编译期拦截。如果项目中部分头文件确实有特殊需求需要引入BigHeader.h，可以通过在方案一中添加例外宏，或者在方案二中允许特定头文件定义授权宏来兼容，但建议严格遵循"头文件只用前置声明"的原则以控制编译成本。

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