一文详细解析Google编码规范工具cpplint的下载安装与使用

一、什么是cpplint

cpplint是一个用于检查C++代码风格的工具，它可以帮助我们自动化地检查代码，发现潜在的编码问题，确保代码风格的一致性和规范性，提高代码质量。cpplint遵循Google的C++编码规范，通过静态分析代码来检查潜在的问题，如命名规范、格式、内存管理等。

注意cpplint仅仅只是给出基于google的编码规范建议，需要我们针对建议去一个个修改：

1、检查代码缩进是否正确。

2、检查变量、函数、类命名是否符合规范。

3、检查代码注释是否符合规范。

4、检查代码行长度是否符合规范。

5、检查头文件包含顺序是否正确。

6、检查代码中潜在的错误和不良习惯。

下载安装这一块，我看网上不少教程都是让去github仓库下载，但是我尝试了一下发现可以直接pip下载，会更加简单快捷。

由于该工具是基于python脚本，所以必须保证先有python环境

去官网下载python文件，一定记得勾选自动添加到环境变量中，

https://www.python.org/downloads/windows/

cmd验证：出现版本号说明环境配置好了，注意是-V(大写)

python -V

此时直接执行命令：pip install cpplint

执行安装程序，看到出现Successfully installed cpplint-1.6.1说明安装成功

安装成功后就可以开始使用，具体的使用方法：

2.1、在需要检查的文件夹下cmd打开终端

2、输入命令：

python xxx\cpplint.py 需要的命令需要检测的文件

这里xxx就是cpplint.py的文件路径，如果觉得麻烦也可以先添加到环境变量里面去

3、此时cpplint就会分析代码并给出结果

来看看cpplint.py的常用命令

打开终端执行命令

python xxx\cpplint.py --help

再次提醒这里xxx就是cpplint.py的文件路径，如果觉得麻烦也可以先添加到环境变量里面去

我们先来看几个常用的：

1、--verbose=#: 这个选项用于设置详细程度。

对于发现的每个问题，cpplint都会给出一个位于区间[1,5]之间的置信度评分，分数越高就代表问题越肯定，可以通过verbose选项控制输出哪些级别，置信度评分为1、2的将不会再输出。通过指定#的值，可以控制输出的详细程度

2、--output=emacs|eclipse|vs7|junit|sed|gsed: 该选项用于指定输出的格式。

可以选择不同的输出格式，如emacs、eclipse、vs7、junit、sed或gsed。默认是emacs，vs7是Visual Studio输出的兼容格式

3、--filter=-x,+y,...: 用于过滤特定的错误或警告。

通过指定-x来排除特定的错误或+y来包含特定的警告，-表示不输出，+表示输出

4、--counting=total|toplevel|detailed: 该选项用于设置错误计数的方式。

可以选择计算总数、仅计算顶层错误或者详细计数。

示例：

--counting=total

输出：Total errors found: 121

命令数不少，就不再一一详细列举，大家可自行查阅参考：

序号	命令	解释
1	--root=subdir:	指定根目录。可以将指定的子目录作为根目录进行检查。
2	--repository=path:	指定存储库路径。可以指定代码存储库的路径。
3	--linelength=digits:	设置每行的字符数限制。通过指定digits的值来设置每行的字符数限制。google cpplint默认是80字符
4	--headers=x,y,...:	指定头文件。可以指定要检查的头文件。
5	--recursive:	递归检查子目录。通过添加此选项，可以递归地检查子目录中的文件。
6	--exclude=path:	排除特定路径。可以指定要排除检查的特定路径。
7	--extensions=hpp,cpp,...:	指定文件扩展名。可以指定要检查的文件扩展名，如hpp、cpp等。
8	--includeorder=default\|standardcfirst:	指定包含文件的顺序。可以选择默认顺序或将标准C头文件放在首位。
9	--quiet:	静默模式。通过添加此选项，可以使输出更加简洁，减少冗余信息。
10	--version:	显示版本信息。通过添加此选项，可以查看cpplint.py的版本信息。