头文件是C工程的骨架，糟糕的设计将导致编译膨胀、依赖混乱与维护地狱。

一、核心守卫：杜绝重复包含

传统宏守卫

现代编译器指令

二、内容规范：什么该进头文件

必须放置

函数声明（extern修饰）

全局变量声明（extern修饰）

宏定义

类型定义（struct, enum, typedef）

嵌套头文件包含

禁止放置

函数定义（inline除外）

变量定义

静态函数声明

三、包含原则：构建清晰依赖

最小依赖原则

仅包含必需的头文件

使用前置声明替代不必要的包含

分层包含结构

应用层 → 模块层 → 硬件抽象层 → 标准库

包含路径规范

系统头文件：#include

本地头文件：#include "path/filename.h"

四、最佳实践

头文件自包含

不依赖其他头文件被先包含

稳定性与修改频率

频繁变更的内容放入独立头文件

接口设计思维

头文件就是API合约，保持稳定

依赖分析工具

使用include-what-you-use等工具优化

本文凡亿教育原创文章，转载请注明来源！