C++代码风格和clang-format配置

C++是Google大部分开源项目的主要编程语言。C++有很多强大特性，但是另一面就是他的复杂性更容易产生bug，难以阅读和维护。

一、常用设置

这里针对项目组常用的习惯。把谷歌代码风格稍微修改了下：

• 每行最大长度由80列扩张到160列
• public/private/protected不需要缩进一个空格

对应的clang-format配置为AccessModifierOffset：访问修饰符的额外缩进或缩进，例如public:.

二、对齐配置

这里把所有的对齐配置选项都罗列出来：

2.1 AlignAfterOpenBracket(BracketAlignmentStyle)

如果true，在左括号后水平对齐参数。

括号包括圆括号（圆括号）、尖括号和方括号。

这里配置的值为：

• BAS_Align（在配置中Align：）对齐开括号上的参数，例如： someLongFunction(argument1,

2.2 AlignConsecutiveMacros(AlignConsecutiveStyle)

对齐连续宏定义的样式。

配置为Consecutive 格式将输出如下：

#define SHORT_NAME       42
#define LONGER_NAME      0x007f
#define EVEN_LONGER_NAME (2)
#define foo(x)           (x * x)
#define bar(y, z)        (y + z)

2.3 AlignEscapedNewlines(EscapedNewlineAlignmentStyle)

用于在转义换行符中对齐反斜杠的选项。

ENAS_Left（在配置中Left：）尽可能向左对齐转义换行符。
true:
#define A   \
  int aaaa; \
  int b;    \
  int dddddddddd;

false:

2.4 操作符对齐AlignOperands (bool)

如果为 true，则水平对齐二元和三元表达式的操作数。

具体来说，这会对齐需要拆分为多行的单个表达式的操作数。

设置为ture：

void func() {
  return some_func(some_variables)
         << "aaaaaaaaaaaaaaasssssssssssssssaaaaaaaaaaaaaaaaaa"
         << "asdaaasssssssss";
}

设置为false：

void func() {
    return some_func(some_variables)
        << "aaaaaaaaaaaaaaasssssssssssssssaaaaaaaaaaaaaaaaaa"
        << "asdaaasssssssss";
}

2.5 对齐注释AlignTrailingComments(Boolean)

如果true，对齐尾随注释。

true:                                   false:
int a;     // My comment a      vs.     int a; // My comment a
int b = 2; // comment  b                int b = 2; // comment about b

2.6 函数初始化列表对齐 AllowAllConstructorInitializersOnNextLine

如果函数调用或花括号初始化器列表不适合一行，则允许将所有参数放到下一行，即使 BinPackArguments是false。

2.7 函数声明对齐 AllowAllParametersOfDeclarationOnNextLine(Boolean)

如果函数声明不适合一行，则允许将函数声明的所有参数放到下一行，即使BinPackParameters是false。

三、是否写成单行配置

3.1 AllowShortBlocksOnASingleLine(ShortBlockStyle)

根据值，可以放在一行中。while (true) { continue; }

3.2 AllowShortCaseLabelsOnASingleLine(Boolean)

如果true，短大小写标签将被压缩为一行

3.3 AllowShortFunctionsOnASingleLine(ShortFunctionStyle)

根据值，可以放在一行中。int f() { return 0; }

3.4 AllowShortLambdasOnASingleLine(ShortLambdaStyle)

根据值，可以放在一行中。auto lambda []() { return 0; }

3.5 AllowShortIfStatementsOnASingleLine(ShortIfStyle)

根据值，可以放在一行中。if (a) return;

3.6 AllowShortLoopsOnASingleLine(Boolean)

如果true,可以放在一行。while(true)continue;