C项目头文件规范 - HeavyYuan/A-CD-Record-Management-System GitHub Wiki

如果一个.c文件不需要.h,且其不是main.c，那么该文件就根本不会存在。

头文件是模块（ Module）或单元（ Unit）的对外接口。头文件中应放置对外部的声明，如对外提供的函数声明、宏定义、类型定义等

内部使用的函数（相当于类的私有方法）声明不应放在头文件中，因此.c文件内部用的函数定义为static。

内部使用的宏、枚举、结构定义不应放入头文件中。

变量定义不应放在头文件中，应放在.c文件中。

变量的声明尽量不要放在头文件中，亦即尽量不要使用全局变量作为接口。

变量是模块或单元的内部实现细节，不应通过在头文件中声明的方式直接暴露给外部，应通过函数接口的方式进行对外暴露。

即使必须使用全局变量，也只应当在.c中定义全局变量，在.h中仅声明变量为全局的。

为了防止list.h被重复include, 那么,list.h的内容应该是：

#ifndef LIST_H
#define LIST_H
... //list.h的真正内容
#endif

以上规范是本项目中遇到的，本文的内容，以及其他规范可以参考：