C语言的头文件包含竟然有那么多讲究!

💡 原文中文,约6900字,阅读约需17分钟。
📝

内容提要

本文讨论了C语言编程中头文件的设计和使用问题,总结了一些规则和建议,如头文件应当职责单一、禁止头文件循环依赖、禁止在头文件中定义变量等。合理的头文件设计可以提高编译效率和系统的可维护性。

🎯

关键要点

  • 头文件应当职责单一,禁止头文件循环依赖。
  • 禁止在头文件中定义变量,以避免重复定义问题。
  • 每个.c文件应有一个同名.h文件,用于声明对外公开的接口。
  • 头文件应向稳定的方向包含,以减少编译时间。
  • 合理的头文件设计可以提高编译效率和系统的可维护性。
  • 头文件应当自包含,避免增加用户负担。
  • 禁止在.c中通过extern的方式使用外部函数接口,必须通过头文件包含。
  • 建议模块中的多个.c文件放在同一目录下,并提供一个对外的.h文件。
  • 头文件不要使用非习惯用法的扩展名,如.inc。
  • 同一产品应统一包含头文件的排列方式,以提高可读性和维护性。
➡️

继续阅读