【摘自《 Google C++ 编程规范》】
- 所有头文件都应该使用
#define
防止头文件被多重包含(multiple inclusion),命名格式一般为
<PROJECT>_<PATH>_<FILE>_H_
- 使用前置声明(forward declaration)尽量减少 .h 文件中 #include 的数量。
- 只有当函数不多于 10 行时才会将其定义为内联函数(inline function)。
- 复杂的内联函数的定义,应放在后缀名为
-inl.h
的头文件中。 - 定义函数时,参数的顺序为:输入参数在前,输出参数在后。
- 包含文件的名称及次序:C 库、C++ 库、其他库的 .h、项目内的 .h。
项目内头文件应该按照项目源代码目录树结构排列。