文章目录
- 1.字符编码
- 2.缩进
- 3.函数
- 3.1 函数声明与定义
- 3.2 函数调用
- 4.Lambda 表达式
- 5.列表初始化
- 6.条件语句
- 7.循环和开关选择语句
- 9.布尔表达式
- 10.函数返回值
- 11.变量及数组初始化
- 12.预处理指令
- 13.类格式
- 14.构造函数初始化列表
- 15.命名空间格式化
- 16.水平留白
- 17.垂直留白
- 参考文献 每个人都可能有自己的代码风格和格式，但如果一个项目中的所有人都遵循同一风格的话，这个项目就能更顺利地进行。每个人未必能同意下述的每一处格式规则，而且其中的不少规则需要一定时间的适应，但整个项目服从统一的编程风格是很重要的，只有这样才能让所有人轻松地阅读和理解代码。
1.字符编码
尽量不要使用非 ASCII 字符，万不得已时才使用。源码文件请使用 UTF8 编码。现如今字符编码种类繁多，每一个国家和地区的本土化字符编码各不相同，为使代码在不同环境下能够正常显示，建议使用统一的 UTF8 编码。
2.缩进
缩进的宽度建议四个空格或一个 Tab，使用 Tab 时请将编辑器的Tab宽度设置为 4 个空格。很多编辑器的 Tab 字符宽度默认为 4 个空格，如 Notepad 、Sublime 与 Source Insight。
3.函数
3.1 函数声明与定义
尽可能精简行数，函数返回类型和函数名在同一行，参数也尽量放在同一行，如果放不下就对形参分行且与第一个形参对齐，或者另起一行且缩进四格，分行方式与函数调用一致。
函数看上去像这样：
代码语言：javascript复制// 函数返回类型、函数名和参数放在同一行
ReturnType ClassName::functionName(Type parName1, Type parName2) {
doSomething();
...
}
// 如果同一行文本太多，放不下所有参数
ReturnType ClassName::functionName(Type parName1, Type parName2,
Type parName3) {
doSomething();
...
}
// 甚至连第一个参数都放不下
ReturnType LongClassName::reallyReallyReallyReallyLongFunctionName(
Type parName1,Type parName2,Type parName3) { // 4 space indent
doSomething(); // 4 space indent
...
}3.2 函数调用
函数调用格式与函数申明与定义格式基本相同，要么一行写完函数调用，要么在圆括号里对参数分行且与第一个参数对齐，要么参数另起一行且缩进四格。如果接收函数返回值，则函数返回值与函数名在同一行。书写形式如下：
代码语言：javascript复制bool retval = doSomething(argument1, argument2, argument3);
//参数分行
bool retval = DoSomething(averyveryveryverylongargument1,
argument2, argument3);
//参数另起一行
bool retval = veryVeryVeryVeryVeryVeryVeryVeryVeryLongFunctionName(
argument1,argument2,argument3, argument4);把多个参数放在同一行以减少函数调用所需的行数，除非影响到可读性。有人认为把每个参数都独立成行，不仅更好读，而且方便编辑参数。不过，比起所谓的参数编辑，我们更看重可读性。如果某参数独立成行, 对可读性更有帮助的话，那也可以如此做。参数的格式处理应当以可读性而非其他作为最重要的原则。此外, 如果一系列参数本身就有一定的结构, 可以酌情地按其结构来决定参数格式：
代码语言：javascript复制// 通过 3x3 矩阵转换 widget.
myWidget.transform(x1, x2, x3,
y1, y2, y3,
z1, z2, z3);如果一些参数本身就是略复杂的表达式，且降低了可读性，那么可以直接创建临时变量描述该表达式，并传递给函数：
代码语言：javascript复制int my_heuristic = scores[x] * y bases[x];
bool retval = doSomething(my_heuristic, x, y, z);4.Lambda 表达式
Lambda 表达式对形参和函数体的格式化和其他函数一致。捕获列表同理，表项用逗号隔开。短 Lambda 就写得和内联函数一样。
代码语言：javascript复制std::set<int> blacklist = {7, 8, 9};
std::vector<int> digits = {3, 9, 1, 8, 4, 7, 1};
digits.erase(std::remove_if(digits.begin(), digits.end(), [&blacklist](int i){
return blacklist.find(i) != blacklist.end();
}),digits.end());5.列表初始化
列表初始化书写格式建议与函数调用格式一致。如果列表初始化伴随着名字，比如类型或变量名，格式化时将将名字视作函数调用名，{}视作函数调用的小括号。如果没有名字，就视作名字长度为零。举例如下：
代码语言：javascript复制//一行列表初始化
return {foo, bar};
functionCall({foo, bar});
pair<int, int> p{foo, bar};
//断行列表初始化
MyType m = { superlongvariablename1,uperlongvariablename2,
{short, interior, list},
{interiorwrappinglist,interiorwrappinglist2}};6.条件语句
（1）小括号内不使用空格
对基本条件语句有两种可以接受的格式，一种在圆括号和条件之间有空格，另一种没有，倾向于不在圆括号内使用空格。如果你是在修改一个文件，参考当前已有格式，如果是写新的代码，参考目录下或项目中其它文件。
代码语言：javascript复制if (condition) { // 圆括号里没有空格
... // 4空格缩进.
} else if (...) { // else 与 if 的右括号同一行
...
} else {
...
}（2）单条语句独立成行且使用大括号 通常，单行语句建议使用大括号，为了避免将来在单行语句之后新增添加代码而忘记添加大括号。复杂的条件或循环语句用大括号可读性会更好。
代码语言：javascript复制//不建议使用
if (condition) DoSomething();
//建议使用
if (condition) {
DoSomething(); // 4空格缩进
}（3）简短单条语句写在同一行且不用大括号 如果能增强可读性，简短的条件语句允许写在同一行且不用添加大括号，只有当语句简单并且没有使用else 子句时使用。
代码语言：javascript复制if (x == kFoo) return new Foo();
if (x == kBar) return new Bar();（4）大括号、if、else、else if独立成行 为了保证代码结构的易读清晰，不要吝惜代码篇幅，建议将大括号、if、else、else if独立成行。
代码语言：javascript复制//代码过于密集，不清晰
if (condition) {
foo;
} else if(...){
bar;
}else{
fooBar;
}
//结构清晰明了易读
if (condition)
{
foo;
}
else if(...)
{
bar;
}
else
{
fooBar;
}7.循环和开关选择语句
在单语句循环里，大括号建议使用：
代码语言：javascript复制//不建议
for (int i = 0; i < kSomeNumber; i)
printf("I love youn");
//建议
for (int i = 0; i < kSomeNumber; i)
{
printf("I take it backn");
}空循环体应使用 {} 或 continue，而不是一个简单的分号。
代码语言：javascript复制while (condition)
{
//反复循环直到条件失效.
}
for (int i = 0; i < kSomeNumber; i) {} //空循环体.
while (condition) continue; //contunue 表明没有逻辑.
while (condition); // 差，看起来仅仅只是 while/loop 的部分之一.switch 语句中的 case 块不建议使用大括号。如果有不满足 case 条件的枚举值，switch 应该总是包含一个 default 匹配。如果 default永远执行不到，简单的加条 assert。
代码语言：javascript复制switch (var) {
case 0: // 4 空格缩进
... // 8 空格缩进
break;
case 1:
...
break;
default:
assert(false);
}#8指针和引用表达式 句点或箭头前后不要有空格，指针/地址操作符 (*, &) 之后不能有空格。正确使用范例：
代码语言：javascript复制x = *p;
p = &x;
x = r.y;
x = r->y;在声明指针变量或参数时, 星号与类型或变量名紧挨都可以：
代码语言：javascript复制//好, 空格前置.
char *c;
const string &str;
//好, 空格后置.
char* c;
const string& str;在单个文件内要保持风格一致, 所以, 如果是修改现有文件, 要遵照该文件的风格。
9.布尔表达式
如果一个布尔表达式超过标准行宽，断行方式要统一一下，逻辑运算符总是位于行首。
代码语言：javascript复制if (this_one_thing > this_other_thing
&&a_third_thing == a_fourth_thing //与上一行的条件对齐
&&yet_another && last_one) //与上一行的条件对齐
{
...
}10.函数返回值
不要在 return 表达式里加上非必须的圆括号。只有在写 x = expr 要加上括号的时候才在 return expr; 里使用括号。
代码语言：javascript复制return result; // 返回值很简单, 没有圆括号.
// 可以用圆括号把复杂表达式圈起来, 改善可读性.
return (some_long_condition &&another_condition);
return (value); // 毕竟您从来不会写 var = (value);
return(result); // return 可不是函数！11.变量及数组初始化
用 =, () 和 {} 均可，建议统一使用大括号形式的列表初始化。
代码语言：javascript复制int x = 3;
int x(3);
int x{3}; //列表初始化
string name("Some Name");
string name = "Some Name";
string name{"Some Name"}; //列表初始化请务必小心列表初始化{…}，用std::initializer_list构造函数初始化出的实例，非空列表初始化就会优先调用std::initializer_list版本的构造函数，不过空列表初始化除外，后者原则上会调用默认构造函数。如果想强制禁用std::initializer_list构造函数，请改用括号。
代码语言：javascript复制vector<int> v(100, 1); // 内容为 100 个 1 的向量.
vector<int> v{100, 1}; // 内容为 100 和 1 的向量.此外, 列表初始化不允许整型类型的四舍五入, 这可以用来避免一些类型上的编程失误.
代码语言：javascript复制int pi(3.14); // 好 - pi == 3.
int pi{3.14}; // 编译错误: 缩窄转换.12.预处理指令
预处理指令不要缩进，从行首开始。即使预处理指令位于缩进代码块中, 指令也应从行首开始。
代码语言：javascript复制// 好 - 指令从行首开始
if (lopsided_score)
{
#if DISASTER_PENDING // 正确 - 从行首开始
DropEverything();
# if NOTIFY // 非必要 - #后跟空格
NotifyClient();
# endif
#endif
BackToNormal();
}
// 差 - 指令缩进
if (lopsided_score)
{
#if DISASTER_PENDING // 差 - "#if" 应该放在行开头
DropEverything();
#endif // 差 - "#endif" 不要缩进
BackToNormal();
}13.类格式
访问控制块的声明依次序是public:, protected:, private:，无需缩进。类声明的基本格式如下。
代码语言：javascript复制class MyClass : public OtherClass {
public: // 无需缩进
MyClass(); // 标准的4空格缩进
explicit MyClass(int var);
~MyClass() {}
void SomeFunction();
void SomeFunctionThatDoesNothing() {}
void set_some_var(int var) {some_var_ = var;}
int some_var() const {return some_var_;}
private:
bool SomeInternalFunction();
int some_var_;
int some_other_var_;
};注意事项： （1）除第一个关键词（一般是 public）外，其他关键词前要空一行，如果类比较小的话也可以不空； （2）public、protected和private这些关键词后不要保留空行； （3）public 放在最前面，然后是 protected，最后是 private。
14.构造函数初始化列表
构造函数初始化列表放在同一行或按四格缩进并排多行。下面两种初始化列表方式都可以接受:
代码语言：javascript复制// 如果所有变量能放在同一行:
MyClass::MyClass(int var) : some_var_(var)
{
doSomething();
}
// 如果不能放在同一行，必须置于冒号后, 并缩进 4 个空格
MyClass::MyClass(int var)
: some_var_(var), some_other_var_(var 1)
{
DoSomething();
}
// 如果初始化列表需要置于多行, 将每一个成员放在单独的一行,并逐行对齐
MyClass::MyClass(int var)
: some_var_(var), // 4 space indent
some_other_var_(var 1) // lined up
{
DoSomething();
}
// 右大括号 } 可以和左大括号 { 放在同一行，如果这样做合适的话
MyClass::MyClass(int var)
: some_var_(var) {}15.命名空间格式化
（1）命名空间内容不缩进，不要增加额外的缩进层次。例如：
代码语言：javascript复制namespace
{
void foo() { // 正确. 命名空间内没有额外的缩进.
...
}
} // namespace
namespace
{
// 错, 缩进多余了.
void foo()
{
...
}
} // namespace（2）声明嵌套命名空间时, 每个命名空间都独立成行。
代码语言：javascript复制namespace foo
{
...
namespace bar
{
...
}
}16.水平留白
水平留白的使用根据在代码中的位置决定，永远不要在行尾添加没意义的留白，坚持一个总领性原则：能不留别就不要添加多余的空白。
代码语言：javascript复制void f(bool b)
{
...
int i = 0; // 分号前不加空格.
int x[] = { 0 }; // 不建议，列表初始化中大括号内的空格多余
int x[] = {0}; // 正确
}
// 继承与初始化列表中的冒号前后恒有空格
class Foo : public Bar
{
public:
// 对于单行函数的实现，在大括号内不要加上空格
void Reset() {baz_ = 0;}
...
}添加冗余的留白会给其他人编辑时造成额外负担，因此，行尾不要留空格。如果确定一行代码已经修改完毕，将多余的空格去掉，或者在专门清理空格时去掉。
17.垂直留白
垂直留白越少越好，这不仅仅是规则而是原则问题了，不在万不得已，不要使用空行，尤其是两个函数定义之间的空行不要超过2行，函数体首尾不要留空行, 函数体中也不要随意添加空行。
基本原则是：同一屏可以显示的代码越多，越容易理解程序的控制流，当然，过于密集的代码块和过于疏松的代码块同样难看，这取决于你的判断，但通常是垂直留白越少越好。
下面的规则可以让加入的空行更有效： （1）函数体内开头或结尾的空行可读性微乎其微； （2）在多重 if-else 块里加空行或许有点可读性。
参考文献
Google C 编程风格指南
