1.#define保护
使用#define防止头文件被多重包含
#ifndef <PROJECT>_<PATH>_<FILE>_H_
#define <PROJECT>_<PATH>_<FILE>_H_
…
#endif // <PROJECT>_<PATH>_<FILE>_H_
举个栗子~：
#ifndef STDIO_H_
#define STDIO_H_#include <stdio.h>
#endif //stdio.h
2.函数参数的顺序
定义函数时, 参数顺序依次为: 输入参数, 然后是输出参数。
3.在 #include 中插入空行
以分割相关头文件, C 库, C++ 库, 其他库的 .h 和本项目内的 .h 是个好习惯。
举个栗子~：
#include “foo/public/fooserver.h” // 优先位置
#include <sys/types.h>
#include <unistd.h>
#include <hash_map>
#include <vector>#include “base/basictypes.h”
#include “base/commandlineflags.h”
#include “foo/public/bar.h”
4.通用命名规则
(1)函数命名，变量命名，文件命名要有描述性；少用缩写。
尽可能给有描述性的命名，别心疼空间，毕竟让代码易于新读者理解很重要。
不要用只有项目开发者能理解的缩写，也不要通过砍掉几个字母来缩写单词。
举个栗子~：
int price_count_reader; // 无缩写
int num_errors; // “num” 本来就很常见
int num_dns_connections; // 人人都知道 “DNS” 是啥
(2)类型名称的每个单词首字母均大写, 不包含下划线: MyExcitingClass, MyExcitingEnum.
举个栗子~：
// classes and structs
class UrlTable { …
class UrlTableTester { …
struct UrlTableProperties { …// typedefs
typedef hash_map<UrlTableProperties *, string> PropertiesMap;// enums
enum UrlTableErrors { …
(3)变量名一律小写, 单词之间用下划线连接.
类的成员变量以下划线结尾, 但结构体的就不用，
如: a_local_variable, a_struct_data_member, a_class_data_member_.
(4)函数命名
常规函数使用大小写混合, 取值和设值函数则要求与变量名匹配: MyExcitingFunction(), MyExcitingMethod(), my_exciting_member_variable(), set_my_exciting_member_variable().
举个栗子~：
常规函数:
函数名的每个单词首字母大写, 没有下划线。
如果您的某函数出错时就要直接 crash, 那么就在函数名加上 OrDie. 但这函数本身必须集成在产品代码里，且平时也可能会出错。
AddTableEntry()
DeleteUrl()
OpenFileOrDie()
取值和设值函数:取值（Accessors）和设值（Mutators）函数要与存取的变量名匹配. 这儿摘录一个类, num_entries_ 是该类的实例变量:
class MyClass {
public:
…
int num_entries() const { return num_entries_; }
void set_num_entries(int num_entries) { num_entries_ = num_entries; }private:
int num_entries_;
};
其它非常短小的内联函数名也可以用小写字母, 例如. 如果你在循环中调用这样的函数甚至都不用缓存其返回值, 小写命名就可以接受.
(5)名字空间用小写字母命名, 并基于项目名称和目录结构: google_awesome_project.
(6)枚举的命名应当和 常量 或 宏 一致: kEnumName 或是 ENUM_NAME.
5.注释
使用 // 或 /* */, 统一就好.
文件注释：在每一个文件开头加入版权公告, 然后是文件内容描述.
每个类的定义都要附带一份注释, 描述类的功能和用法.
函数声明处注释描述函数功能; 定义处描述函数实现.
举个栗子~：
// Returns true if the table cannot hold any more entries.
bool IsTableFull();
6.格式
(1)行长度:每一行代码字符数不超过 80.
(2)返回类型和函数名在同一行, 参数也尽量放在同一行，如果放不下就对形参分行。
举个栗子~：
ReturnType ClassName::ReallyLongFunctionName(Type par_name1, Type par_name2,
Type par_name3) {
DoSomething();
…
}ReturnType LongClassName::ReallyReallyReallyLongFunctionName(
Type par_name1, // 4 空格缩进
Type par_name2,
Type par_name3) {
DoSomething(); // 2 空格缩进
…
}
(3)条件语句：倾向于不在圆括号内使用空格. 关键字 if 和 else 另起一行.
所有情况下 if 和左圆括号间都有个空格. 右圆括号和左大括号之间也要有个空格.
举个栗子~：
if (condition) { 圆括号里没空格紧邻。
… // 2 空格缩进。
} else { // else 与 if 的右括号同一行。
…
}
warning:
if(condition) // 差 – IF 后面没空格。
if (condition){ // 差 – { 前面没空格。
if(condition){ // 变本加厉地差。
如果语句中某个 if-else 分支使用了大括号的话, 其它分支也必须使用:
// 不可以这样子 – IF 有大括号 ELSE 却没有。
if (condition) {
foo;
} else
bar;// 不可以这样子 – ELSE 有大括号 IF 却没有。
if (condition)
foo;
else {
bar;
}
(4)空循环体应使用 {} 或 continue, 而不是一个简单的分号.
while (condition) {
// 反复循环直到条件失效。
}
for (int i = 0; i < kSomeNumber; ++i) {} // 可 – 空循环体。
while (condition) continue; // 可 – continue 表明没有逻辑。
(5)句点或箭头前后不要有空格. 指针/地址操作符 (*, &) 之后不能有空格.
举个栗子~：
下面是指针和引用表达式的正确使用范例:
x = *p;
p = &x;
x = r.y;
x = r->y;
(6)在声明指针变量或参数时, 星号与类型或变量名紧挨都可以:
// 好样的，空格前置。
char *c;
const string &str;// 好样的，空格后置。
char* c; // 但别忘了 “char* c, *d, *e, …;”!
const string& str;char * c; // 差 – * 两边都有空格
const string & str; // 差 – & 两边都有空格。
(7)如果一个布尔表达式超过 标准行宽, 断行方式要统一一下.如逻辑与 (&&) 操作符总位于行尾:
if (this_one_thing > this_other_thing &&
a_third_thing == a_fourth_thing &&
yet_another & last_one) {
…
}
(8)预处理指令不要缩进, 从行首开始.即使预处理指令位于缩进代码块中, 指令也应从行首开始.
// 可 – directives at beginning of line
if (lopsided_score) {
#if DISASTER_PENDING // 正确 — 行开头起。
DropEverything();
#endif
BackToNormal();
}
(9)类格式：访问控制块的声明依次序是 public:, protected:, private:, 每次缩进 1 个空格.
如：
class MyClass : public OtherClass {
public: // 注意有 1 空格缩进!
MyClass(); // 照常，2 空格缩进。
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_;
DISALLOW_COPY_AND_ASSIGN(MyClass);
};
(10)名字空间内容不缩进.
名字空间 不要增加额外的缩进层次, 例如:
namespace {
void foo() { // 正确。命名空间内没有额外的缩进。
…
}} // namespace
(11)循环和条件语句:
if (b) { // if 条件语句和循环语句关键字后均有空格。
} else { // else 前后有空格。
}
while (test) {} // 圆括号内部不紧邻空格。
switch (i) {
for (int i = 0; i < 5; ++i) {
switch ( i ) { // 循环和条件语句的圆括号里可以与空格紧邻。
if ( test ) { // 圆括号，但这很少见。总之要一致。
for ( int i = 0; i < 5; ++i ) {
for ( ; i < 5 ; ++i) { // 循环里内 ; 后恒有空格，； 前可以加个空格。
switch (i) {
case 1: // switch case 的冒号前无空格。
…
case 2: break;// 如果冒号有代码，加个空格。
}
for (int i = 0; i < kSomeNumber; ++i)// 循环里内 ; 后恒有空格
printf(“I love you\n”);
(12)return; 比 return ; 更约定俗成（事实上 cpplint 会对后者报错，指出分号前有多余的空格），且可用来提前跳出函数栈。
事实上，如果您熟悉英语本身的书写规则，就会发现该风格指南在格式上的规定与英语语法相当一脉相承。比如普通标点符号和单词后面还有文本的话，总会留一个空格；特殊符号与单词之间就不用留了，比如 if (true) 中的圆括号与 true.
❤ 点击这里 -> 订阅《PAT | 蓝桥 | LeetCode学习路径 & 刷题经验》by 柳婼
❤ 点击这里 -> 订阅《从放弃C语言到使用C++刷算法的简明教程》by 柳婼
❤ 点击这里 -> 订阅PAT甲级乙级、蓝桥杯、GPLT天梯赛、LeetCode题解离线版
