【C++】Google编码风格学习

Google规范线上地址:https://zh-google-styleguide.readthedocs.io/en/latest/

1. 头文件

每个cpp/cc文件都对应一个h头文件,除单元测试代码和只包含main()的文件外。

所有头文件都应该有 #define 保护来防止头文件被多重包含,命名格式:<PROJECT>_<PATH>_<FILE>_H_,如:

#ifndef FOO_BAR_BAZ_H_
#define FOO_BAR_BAZ_H_
...
#endif // FOO_BAR_BAZ_H_

当函数被声明为内联函数后,编译器会将其内联展开,而不是按通常的函数调用机制进行调用。(注意:只有当函数只有 10 行或者更少时才将其定义为内联函数)

使用标准的头文件包含顺序可增强可读性,避免隐藏依赖,顺序如下:相关头文件, C 库, C++ 库,其他库的.h,本项目内的.h

2. 作用域

命名空间将全局作用域细分为独立的,具名的作用域,可有效防止全局作用域的命名冲突。另外,一般在命名空间的最后注释出命名空间的名字。

3. 类

类是 C++ 中代码的基本单元。

在构造函数中可以进行各种初始化操作。

仅当只有数据成员时使用 struct,其它一概使用 class

接口是指满足特定条件的类,这些类以 Interface 为后缀 (不强制)。

4. 函数

函数使用时倾向于按值返回,否则按引用返回。避免返回指针,除非它可以为空。

函数最好简短、凝练,避免拖长尾。

所有按引用传递的参数必须加上const

若要使用函数重载,则必须能让读者一看调用点就胸有成竹,而不用花心思猜测调用的重载函数到底是哪一种,这一规则也适用于构造函数。

5. 其他C++特性

禁止使用 C++ 异常。

使用 C++ 的类型转换,如 static_cast<>()。不要使用 int y = (int)x 或 int y = int(x) 等转换方式。

强烈建议你在任何可能的情况下都要使用 const. 此外有时改用 C++11 推出的 constexpr 更好。

C++ 没有指定整型的大小。通常人们假定 short 是16位,int是32位,long是32位,long long是64位。

适当使用 lambda 表达式。别用默认 lambda 捕获,所有捕获都要显式写出来。

只使用 Boost 中被认可的库。

6. 命名约定

函数命名,变量命名,文件命名要有描述性,少用缩写。

文件名要全部小写,可以包含下划线(_)或连字符(-),依照项目的约定,如果没有约定,那么“”更好。

7. 注释

使用///**/,统一就好。

函数声明处的注释描述函数功能,定义处的注释描述函数实现。

函数的输入输出。
对类成员函数而言: 函数调用期间对象是否需要保持引用参数, 是否会释放这些参数。
函数是否分配了必须由调用者释放的空间。
参数是否可以为空指针。
是否存在函数使用上的性能隐患。
如果函数是可重入的, 其同步前提是什么?

通常变量名本身足以很好说明变量用途。某些情况下,也需要额外的注释说明。

8. 格式

每一行代码字符数不超过80。

尽量不使用非 ASCII 字符,使用时必须使用UTF-8编码。

只使用空格,每次缩进2个空格。

倾向于不在圆括号内使用空格,关键字 ifelse 另起一行。

switch 语句可以使用大括号分段,以表明 cases 之间不是连在一起的。在单语句循环里,括号可用可不用。空循环体应使用{}或 continue

在这里插入图片描述

最后,请注意项目整体代码风格尽量保持一致,这样可以把精力集中在实现内容而不是表现形式上。

以上。

猜你喜欢

转载自blog.csdn.net/qq_40344790/article/details/129498803