静态代码检查利器:golangci

您所在的位置:网站首页 静态检查的内容 静态代码检查利器:golangci

静态代码检查利器:golangci

2023-08-19 05:07| 来源: 网络整理| 查看: 265

1.静态代码检查

静态代码检查是一个老生常谈的问题,它通过对源代码进行分析,找出其中的潜在问题和错误,以提高代码质量和可维护性。

Go 语言的静态代码检查工具较多,常见的有:

go vet:go 自带的一个静态代码检查工具,可以检测代码中常见的错误和潜在问题。 golangci-lint:一个基于 go vet 和 golint 等的集成工具,支持对项目进行全面的静态代码检查。 golint:golang 官方提供的代码风格检查工具,可以检查代码是否符合官方规范。 staticcheck:一个快速、精确的静态代码分析工具,可以检测更加复杂的错误和潜在问题。 revive:另一个轻量级的静态代码检查工具,可以检测代码中的错误和不良习惯,并提供修复建议。 ...

以上谈到的工具,我们可以称之为 linter。在维基百科是如下定义 lint 的:

在计算机科学中,lint 是一种工具程序的名称,它用来标记源代码中,某些可疑的、不具结构性(可能造成 bug)的段落。它是一种静态程序分析工具,最早适用于 C 语言,在 UNIX 平台上开发出来。后来它成为通用术语,可用于描述在任何一种计算机程序语言中,用来标记源代码中有疑义段落的工具。

其中 golangci-lint 是比较受欢迎的,使用人数也比较多的静态代码检查工具。golangci-lint 集成了非常多的 linter,包括上文提到的 govet,revive 等。

接下来,我们就来聊聊 golangci-lint。

2.为什么选择 golangci-lint?

golangci-lint 相比其他的静态代码检查工具,我觉得显著的优点有:

**速度快:**golangci-lint 是基于 gometalinter 开发的,但是平均速度要比 gometalinter 快 5 倍。速度快的原因有三个: 可以并行执行 linter 检查代码; 可以复用 go build 缓存; 会缓存分析结果。 **可配置:**可以基于 yaml 编写配置文件,更灵活可控。 **可集成:**能够集成主流的 IDE,如 VS Code, Sublime Text, GoLand, GNU Emacs, Vim 等。 **linter 集大成者:**以 v1.52.2 的官方文档来看,已经聚合了 100+ 个 linter,并且不需要去额外安装他们。 **最小的误报数:**得益于 golangci-lint 调整了所聚合的 linter 的默认值。 **输出美观:**可携带颜色、源码行号、linter 标识,方便定位。

除此之外,golangci-lint 还在保持更新迭代,还在不断地更新 linter。有这么全的 linter 为你的代码保驾护航,你在提交代码时肯定会多一分从容与自信。

目前,有很多公司 / 项目使用了 golangci-lint 工具作为静态代码检查工具,例如 Google、Facebook、Istio、Red Hat OpenShift 等。

3 下载

官方文档提供了多种下载方式,我们这里使用官方提供 curl 命令来进行下载:

$ curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin golangci/golangci-lint info checking GitHub for latest tag golangci/golangci-lint info found version: 1.52.2 for v1.52.2/darwin/arm64 golangci/golangci-lint info installed ${YOUR_GOPATH}/bin/golangci-lint

如果条件允许的话,可以定期更新 golangci-lint 的版本,毕竟它仍在积极地更新。

之后,我们可以通过 golangci-lint version 来检查是否安装成功:

$ golangci-lint version golangci-lint has version 1.52.2 built with go1.20.2 from da04413a on 2023-03-25T18:11:28Z

似乎新版本使用 go get 命令不能将 golangci-lint 可执行程序安装到你的 GOPATH。

我们还可以查看默认生效或不生效的 linter 以及 linter 的分类:

$ golangci-lint help linters 4 命令和选项

我们可以通过执行 golangci-lint -h 查看其用法,golangci-lint 支持的子命令如下:

子命令功能cache缓存控制并打印缓存的信息completion生成 bash/fish/powershell/zsh 等自动补全脚本config打印 golangci-lint 当前使用的配置文件路径help打印 golangci-lint 的帮助信息linters打印 golangci-lint 支持的 linter,并按启用/禁用分类run执行 golangci-lint 对代码进行检查version查看 golangci-lint 版本号

此外,golangci-lint 还支持一些全局选项。全局选项是指适用于所有子命令的选项,golangci-lint 支持的全局选项如下:

选项功能--color是否带颜色打印,有 3 个值:always、auto(默认值)、never-j, --concurrency控制并发数(默认 NumCPU/10)--cpu-profile-path记录 CPU 性能数据到指定文件-h, --help输出 golangci-lint 的帮助信息--mem-profile-path记录内存性能数据到指定文件--trace-path跟踪文件路径-v, --verbose生成更多信息--version版本号

接下来,我们介绍一下 golangci-lint 的核心子命令:run、cache、completion、config、linters。

4.1 run

run 命令执行 golangci-lint,对代码进行检查,是 golangci-lint 最为核心的一个命令。run 没有子命令,

4.2 cache

cache 命令用于缓存控制并打印缓存的信息,它有两个子命令:

clean:清除 cache,常用于缓存出错或缓存内容过大时; status:打印 cache 相关的一些信息,如缓存目录和大小。 $ golangci-lint cache status Dir: /Users/xxx/Library/Caches/golangci-lint Size: 64B 4.3 completion

completion 命令包含 4 个子命令 bash、fish、powershell 和 zsh,分别用来输出 bash、fish、powershell 和 zsh 的自动补全脚本。

下面是一个配置在 macOS 的 bash 自动补全的示例:

echo 'source


【本文地址】


今日新闻


推荐新闻


CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3