格式
1 行宽
总述
每一行代码字符数不超过 100.
说明
100 个字符是最大值.
如果无法在不伤害易读性的条件下进行断行, 那么注释行可以超过 100 个字符, 这样可以方便复制粘贴. 例如, 带有命令示例或 URL 的行可以超过 100 个字符.
包含长路径的 #include 语句可以超出100列.
2 空格还是制表符
总述
只使用空格, 每次缩进 2 个空格.
说明
我们使用空格缩进. 不要在代码中使用制表符. 你应该设置编辑器将制表符转为空格.
3 函数声明与定义
总述
返回类型和函数名在同一行, 参数也尽量放在同一行, 如果放不下就对形参分行, 分行方式与 函数调用 一致.
注意点:
使用好的参数名.
只有在参数未被使用或者其用途非常明显时, 才能省略参数名.
如果返回类型和函数名在一行放不下, 分行.
如果返回类型与函数声明或定义分行了, 不要缩进.
左圆括号总是和函数名在同一行.
函数名和左圆括号间永远没有空格.
圆括号与参数间没有空格.
左大括号总在最后一个参数同一行的末尾处, 不另起新行.
右大括号总是单独位于函数最后一行, 或者与左大括号同一行.
右圆括号和左大括号间总是有一个空格.
所有形参应尽可能对齐.
缺省缩进为 2 个空格.
换行后的参数保持 4 个空格的缩进.
4 条件语句
总述
倾向于不在圆括号内使用空格. 关键字 if 和 else 另起一行.
说明
//a: 只要其中一个分支用了大括号, 两个分支都要用上大括号.
if (condition) {
foo;
} else {
bar;
}
//b: 当语句非常简单的时候,简短的条件语句允许写在同一行.
if (x == kFoo) return new Foo();
if (x == kBar) return new Bar();
5 循环和开关选择语句
总述
switch 语句可以使用大括号分段, 以表明 cases 之间不是连在一起的. 在单语句循环里, 括号可用可不用.空循环体应使用 {} 或 continue.
说明
空循环体应使用 {} 或 continue, 而不是一个简单的分号.
while (condition) {
// 反复循环直到条件失效.
}
for (int i = 0; i < kSomeNumber; ++i) {} // 可 - 空循环体.
while (condition) continue; // 可 - contunue 表明没有逻辑.
```
while (condition); // 差 - 看起来仅仅只是 while/loop 的部分之一.
```
6 指针和引用表达式
总述
句点或箭头前后不要有空格. 指针/地址操作符 (*, &) 之后不能有空格.
错误实例
int x, *y; // 不允许 - 在多重声明中不能使用 & 或 *
char * c; // 差 - * 两边都有空格
const string & str; // 差 - & 两边都有空格.
7 布尔表达式
总述
如果一个布尔表达式超过 标准行宽, 断行方式要统一一下.
说明
下例中, 逻辑与 (&&) 操作符总位于行尾.此外, 直接用符号形式的操作符, 比如 && 和 ~, 不要用词语形式的 and 和 compl.
if (this_one_thing > this_other_thing &&
a_third_thing == a_fourth_thing &&
yet_another && last_one) {
...
}
8 变量及数组初始化
总述
用 =, () 和 {} 均可.
说明
特例1:但是注意列表初始化要使用()
请务必小心列表初始化 {…} 用 std::initializer_list 构造函数初始化出的类型. 非空列表初始化就会优先调用 std::initializer_list, 不过空列表初始化除外, 后者原则上会调用默认构造函数. 为了强制禁用 std::initializer_list 构造函数, 请改用括号.
vector<int> v(100, 1); // 内容为 100 个 1 的向量.
vector<int> v{100, 1}; // 内容为 100 和 1 的向量.
特例2:变量初始化要使用{}|
int pi(3.14); // 好 - pi == 3.
int pi{3.14}; // 编译错误: 缩窄转换.
9 预处理指令
总述
预处理指令不要缩进, 从行首开始.这是规定.
示例
// 好 - 指令从行首开始
if (lopsided_score) {
#if DISASTER_PENDING // 正确 - 从行首开始
DropEverything();
# if NOTIFY // 非必要 - # 后跟空格
NotifyClient();
# endif
#endif
BackToNormal();
}
10 编码格式
总述
跨平台的代码一定使用UTF-8格式,尽量不将字符串常量耦合到代码中, 比如独立出资源文件, 这不仅仅是风格问题了。
11 留白
总述
水平留白的使用根据在代码中的位置决定. 永远不要在行尾添加没意义的留白.
垂直留白越少越好.
说明
这不仅仅是规则而是原则问题了: 不在万不得已, 不要使用空行. 尤其是: 两个函数定义之间的空行不要超过 2 行, 函数体首尾不要留空行, 函数体中也不要随意添加空行.
基本原则是: 同一屏可以显示的代码越多, 越容易理解程序的控制流. 当然, 过于密集的代码块和过于疏松的代码块同样难看, 这取决于你的判断. 但通常是垂直留白越少越好.