Question

此处以 Google 编码规范为主，辅以其他内容。

Google , Linux

1. 命名

文件和变量名全部小写，以下划线连接。区分大小写！以下划线开始的名字通常是系统保留。全局变量和函数应该具有描述性的名字，局部变量应短小简练。宏、常量、枚举、标签大写，但宏函数名称小写。

2. 类型

用 typedef 定义类型别名，添加 _t 后缀。

3. 变量

鼓励使用 static 内链接变量，不能放在头文件中。变量应该有最小作用域，每个一行，定义时初始化。在 for 等语句块内定义局部变量。

for (int i = 0; i < 1000000; ++i) { }

4. 函数

鼓励使用 static 内链接函数，减少全局函数。函数应简短、凝练。超过 40 行的函数，应考虑拆分重构。输入参数在前，输出参数在后。尽可能为引用参数添加 const，减少无意修改。

内联

滥用内联会导致代码变大，可能拖累载入速度，甚至是指令缓存。只有代码在 10 行以内，才使用内联（inline）。不要内联包含循环和大量选择的函数。

5. 头文件

添加保护，防止被多重包含。

#ifndef FOO_BAR_BAZ_H_  // <PROJECT>_<PATH>_<FILE>_H_
#define FOO_BAR_BAZ_H_

...

#endif // FOO_BAR_BAZ_H_

尽可能使用前置声明，而不是过多的 #include ，以节省编译时间。在源码文件中，使用 #include 顺序。

#include <标准库>
#include "第三方库"
#include "当前项目"