本文假设读者已具备基本的C编译常识。如非稀奇诠释开云kaiyun中国官方网站，文中“源文献”指 * .c文献，“头文献”指 *.h文献，“援用”指包含头文献。
一、头文献作用
C说话里，每个源文献是一个模块，头文献为使用该模块的用户提供接口。接口指一个功能模块自大给其他模块用以访谒具体功能的门径。
使用源文献终了模块的功能，使用头文献自大单位的接口。用户只需包含相应的头文献就可使用该头文献中自大的接口。
通及其文献包含的门径将要领中的各功能模块有计划起来有益于模块化要领缠绵：
1）通及其文献调用库功能。在好多场地，源代码未便(或不准)向用户公布，只须向用户提供头文献和二进制库即可。用户只需按照头文献中的接口声明来调用库功能，而无须温煦接口怎样终了。编译器会从库中索求相应的代码。
2）头文献能加强类型安全查验。若某个接口的终了或使用方式与头文献中的声明不一致，编译器就会指出虚假。这一简便的规则能大大缩小要领员调试、改错的背负。
在预照看阶段，编译器将源文献包含的头文献内容复制到包含语句(#include)处。在源文献编译时，连同被包含进来的头文献内容一皆编译，生成宗旨文献(.obj)。
如果所包含的头文献荒谬纷乱，则会严重镌汰编译速率(使用GCC的-E选项可取得并检察最终预照看完的文献)。因此，在源文献中应仅包含必需的头文献，且尽量不要在头文献中包含其它头文献。
二、 头文献组织原则
源文献中终了变量、函数的界说，并指定结合鸿沟。头文献中书写外部需要使用的全局变量、函数声明及数据类型和宏的界说。
建议组织头文献内容时解任以下原则：
1）头文献离别原则：类型界说、宏界说尽量与函数声明相分离，分别位于不同的头文献中。里面函数声明头文献与外部函数声明头文献相分离，里面类型界说头文献与外部类型界说头文献相分离。
谨防，类型和宏界说偶而无法分拆为不同文献，比如结构体内数构成员的元素个数用常量宏暗意时。因此仅分离类型宏界说与函数声明，且分别置于*.th和*.fh文献(并非强制要求)。
2）头文献的语义头绪化原则：头文献需要有语义头绪。不同语义头绪的类型界说不要放在一个头文献中，不同头绪的函数声明不要放在一个头文献中。
3）头文献的语义有计划性原则：归并头文献中出现的类型界说、函数声明应该是语义有计划的、有里面逻辑相关的，幸免将无关的界说和声明放在一个头文献中。
4）头文献名应尽量与终了功能的源文献疏浚，即module.c和module.h。但源文献不一定要包含其同名的头文献。
5）头文献中不应包含土产货数据，以镌汰模块间耦合度。
即只须源文献我方使用的类型、宏界说和变量、函数声明，不应出当今头文献里。作用域限于单文献的独到变量和函数应声明为static，以注重外部调用。将独到类型置于源文献中，会培育团员度，并减少无须要的体式外漏。
6）头文献内不允许界说变量和函数，只可有宏、类型(typedef/struct/union/enum等)及变量和函数的声明。
稀奇情况下可extern基本类型的全局变量，源文献通过包含该头文献访谒全局变量。但头文献内不应extern自界说类型(如结构体)的全局变量，不然将迫使本不需要访谒该变量的源文献包含自界说类型场所头文献[1]。
7）诠释性头文献不需要有对应的源文献。此类头文献内大多包含大批主张性宏界说或排列类型界说，不包含任何其他类型界说和变量或函数声明。此类头文献也不应包含任何其他头文献。
8）使用#pragma once或header guard(亦称include guard或macro guard)幸免头文献重迭包含。#pragma once是一种非圭臬但已被当代编译器平方提拔的手段，它明确奉告预照看器“不要重迭包含刻下头文献”。而header guard则通过预照看呐喊模拟访佛活动：
使用#pragma once比拟header guard具有两个优点：
① 更快。编译器不会第二次读取标识#pragma once的文献，但却会读些许遍使用header guard 的文献(寻找#endif)；
② 更简便。不再需要为每个文献的header guard取名，幸免宏名重名激勉的“找不到声明”问题。
过失则是：
#pragma once保证物理上的归并个文献不会被包含屡次，无法冤家文献中的一段代码作#pragma once声明。若某个头文献具有多份拷贝(内容疏浚的多个文献)，pragma不可保证它们不被重迭包含。虽然，这种重迭包含很容易被发现并修正。
9）C++中要援用C函数时，函数场所头文献内应包含extern "C"。
被extern "C"修饰的变量和函数将按照C说话方式编译和结合，不然编译器将无法找到C函数界说，从而导致结合失败。
10）头文献内要有面向用户的满盈凝视，从哄骗角度描写接口自大的内容。
三、 头文献包含原则
在内容编程中，时时因头文献包含不当而激勉编译时解释象征未界说的虚假或重迭界说的劝诫。
要捣毁象征未界说的编译虚假，只需在援用象征(变量、函数、数据类型及宏等)前确保它已被声明或界说[4]。要捣毁重迭界说的劝诫，则需合理缠绵头文献包含递次和头绪。
建议包含头文献时解任以下原则：
1）源文献内的头文献包含递次应从最稀奇到一般，
如：
优点是每个头文献必须include需要的关联头文献，不然会报错。
同期，源文献同名头文献置于包含列表前端便于查验该头文献是否自完备，以及类型或函数声明是否与圭臬库毒害。
2）减少头文献的嵌套和交叉援用，头文献仅包含其确实需要显式包含的头文献。
举例，头文献A中出现的类型界说在头文献B中，则头文献A应包含头文献B，除此之外的其他头文献不允许包含。
头文献的嵌套和交叉援用会使要领组织结构和文献组织变得繁芜，同期形成潜在的虚假。大型工程中，原有头文献可能会被多个其他(源或头)文献包含，在原有头文献中添加新的头文献往往牵一发而动全身。若头文献中类型界说需要其他头文献时，可将其建议来单独形成一个全局头文献。
3）头文献应包含哪些头文献仅取决于自己，而非包含该头文献的源文献。
举例，编译源文献时需要用到头文献B，且源文献已包含头文献A，而索性将头文献B包含在头文献A中，这是虚假的作念法。
4）尽量保证用户使用此头文献时，无需手动包含其他前提头文献，即此头文献内已包含前提头文献。
举例，面积有计划操作的头文献Area.h内已包含对于点操作的头文献Point.h，则用户包含Area.h后无需再手动包含Point.h。这么用户就无须了解头文献的内在依赖相关。
5）头文献应是自完备的，即在职一源文献中包含任一头文献而不会产生编译虚假。
6）源文献中包含的头文献尽量不要有递次依赖。
7）尽量在源文献中包含头文献，而非在头文献中。且源文献仅包含所需的头文献。
8）头文献中若能前置声明(亦称前向声明[5])，就不要包含另一头文献。仅刻下置声明不可舒适或过于贫穷时才使用include，如斯可减少依赖性方面的问题。
示举例下：
如上，在OmciChkFunc函数的终了源文献内包含T_MeInfoMap和T_OmciMsg场所头文献即可。
另举一举例下：
如上，CompareRecFunc函数原型由其他头文献提供，此处为幸免头文献交叉援用界说其异名同构原型CmpRecFunc。
在不会引起歧义的前提下，头文献内尽可能使用VOID指针代替非基本类型的值变量或指针，以幸免再包含类型界说场所的头文献。但这将影响代码可读性并镌汰要领履行后果，应量度轻重。
9）幸免包含分量级的平台头文献，如windows.h或d3d9.h等。若仅使用该头文献极少函数，可extern函数到源文献内。如下：
若还使用该头文献某些类型和宏界说，可创建适配性源文献。在该源文献内包含平台头文献，封装新的接口并将其声明在同名头文献内，其他源文献将通过适佳偶文献障碍拜谒平台接口。如下：
10）对于函数库(包括圭臬库和自界说的全球宏及接口)的头文献，可将其加入到一个通用头文献中。需要限度该头文献的体积(主若是该头文献所包含的扫数头文献内容大小)，并确保扫数源文献最初包含该通用头文献。示举例下：
谨防，示例头文献内包含C库文献虽能简化包含，但却与规则1毒害。也可另外加多包含库文献列表的通用头文献。
11）若不细目类型、宏界说或函数声明场所头文献具体旅途，可在源文献中再次界说或声明，编译器会以redefined劝诫或conflicting虚假给出类型、宏界说或函数声明场所头文献旅途。
四、代码文献组织原则
建议C说话口头中代码文献组织解任以下原则：
1）使用头绪化和模块化的软件缔造模子。每个模块只可使用场所层和下一层模块提供的接口。
2）每个模块的文献(可能多个)保存在一个平安文献夹中。
模块文献较多时可罗致子目次的方式，物理上阻遏不同头绪的文献。子目次下源文献和头文献应分开存放，如分别置入include和source目次。
3）用于模块裁减的条款编译宏保存在一个平安文献中，便于软件裁减。
4）硬件有计划代码和操作系统有计划代码与工程代码相对平安保存，以便于软件移植。
5）按疏浚功能或有计划性组织源文献和头文献。归并文献内的团员度要高，不同文献中的耦合度要低。
在对既有工程作念单位测试时，耦合度低的文献布局荒谬便于搭建环境。
6）声明和界说分开，使用头文献自大模块需要提供给外部的类型、宏、变量和函数。尽量作念到模块对外部透明，用户在使用模块功能时无需了解具体的终了。
7）算作对外接口的头文献还是发布，应保捏褂讪。修改时一定要谨慎。
8）文献夹和文献定名要粗略反应出模块的功能。
9）郑再版块和测试版块使用息争文献，使用宏限度是否产生测试输出。
10）必要的凝视不可枯竭开云kaiyun中国官方网站。