Alan Donovan 提出新 Proposal:要让 go test 运行自定义静态分析器!

Alan Donovan 提出新 Proposal:要让 go test 运行自定义静态分析器!

💡 原文中文,约8400字,阅读约需20分钟。
📝

内容提要

Go团队核心成员Alan Donovan提出提案,让go test能够运行项目自定义的静态分析器。方案从goanalysis.go演进为go.vet配置文件,支持目录级规则声明与启用禁用,并基于go/analysis框架构建任务图并行执行。Alan还划分了go vet、go.vet、gopls三层定位,将静态分析视为“静态测试”,并申请在Go 1.28中实验性尝鲜。

🔎

延伸解读

从“工具链写死”到“项目自治”

提案的核心变化是让项目自己声明要跑哪些分析器,而不是只能依赖 go test 内置的 go vet 检查。过去项目专属规则如 Lock/Unlock 配对、内部 API 禁用等,往往要另建 CI 步骤或依赖 golangci-lint。go.vet 文件把规则放回代码目录,使本地 go test 与 CI 使用同一份配置,减少“本地没跑、CI 才报”的不一致。

go.vet 只做声明,不接管参数配置

Alan Donovan 明确不打算让 go.vet 统一管理每个 Analyzer 的 Flags,原因是不同驱动(命令行、gopls、staticcheck)各有配置方式,强行统一反而更复杂,还可能和并发执行冲突。因此这套机制聚焦于“运行哪些分析器、作用范围多大”,具体参数仍由各分析器自行处理。读者不宜期待它成为万能 lint 配置中心。

三层分工:go vet、go.vet、gopls

文章转述 Alan 的划分:内置 go vet 面向所有 Go 项目的基础底线;go.vet 承载模块维护者希望强制执行的规则;gopls 则服务开发者个人偏好。这个分层解释了为何在已有 staticcheck、golangci-lint 的情况下仍要让 go test 参与:它把项目级约束放进日常测试循环,而非依赖个人编辑器设置或额外命令。

实验性尝鲜,尚未定论

截至 2026 年 11 月 18 日,提案 #82464 仍为 Open,Go 1.28 的 freeze exception 只是申请,未获批。实现计划由 GOEXPERIMENT=vetfiles 控制,默认不影响普通用户。此外,让 go test 运行仓库声明的分析器涉及信任边界问题,打开陌生仓库时是否应自动触发仍需授权机制,文章指出这不应阻碍 go test 先行支持。

❓

Q&A

Go 的 go test 目前已经会运行哪些静态检查?为什么还需要自定义分析器?

go test 目前会运行内置的 go vet 分析器集合,例如 printf、copylocks、loopclosure 等,用于发现编译器无法发现但很可能是错误的问题。但项目自身的特殊约束(如 Lock/Unlock 配对、AddRef/DecRef 配对、内部 API 使用限制等)无法通过编译器检查,目前需要单独构建和运行自定义分析器,导致本地与 CI 规则可能不一致。Alan Donovan 的提案正是为了让 go test 能自动运行项目声明的自定义分析器。

这个提案的配置文件为什么从 goanalysis.go 改成了 go.vet?

最初方案使用 goanalysis.go 文件以 Go 代码声明分析器,但社区讨论(如 Ian Lance Taylor 建议放入 go.mod)后,Alan 更倾向于独立文件以实现目录自治:规则可以跟随代码所在目录,而不必集中到模块根目录。到 Mk.5 版本,配置文件更名为 go.vet,并引入 enable/disable 等更明确的启用禁用机制。

go.vet 配置文件具体怎么写?如何启用或禁用某个分析器?

根据文章示例,go.vet 中可以用 enable 和 disable 指令,格式为 enable . "myAnalyzer" 或 disable . "printf",其中 . 表示配置适用的范围,后面的字符串指定 Analyzer 名称。此外还支持不同的分析作用域,并可通过 go test -debug-vetconfig 查看最终生效的分析配置。

go test 运行自定义分析器时,是如何组织执行和并行的?

提案继续基于 golang.org/x/tools/go/analysis 框架,Analyzer 可以声明依赖其他 Analyzer(通过 Requires、FactTypes 等)。执行系统会理解分析器之间的依赖关系,将其组织成任务图,而不是简单遍历列表逐个调用。这种任务图也为并行执行和缓存提供了基础,并与单元测试并行跑通,深度复用 Go 构建缓存。

Alan Donovan 如何划分 go vet、go.vet 和 gopls 三者的定位?

Alan 给出了三层划分:Go 项目整体使用内置 go vet 分析器集合,负责所有 Go 项目都应接受的基础检查;Module 维护者使用本提案引入的 go.vet,承载项目自身希望强制执行的静态分析规则;个人 Go 开发者使用 gopls 分析器集合及个人配置,关注开发者自己的编码习惯和偏好。他还将静态分析视为源代码层面的“静态测试”,与动态的行为测试互补。

这个提案目前进展到哪一步了?会在 Go 1.28 中默认启用吗?

截至 2026 年 11 月 18 日,提案 #82464 仍处于 Open 状态,带有 Proposal 和 Analysis 标签。Alan 已公开设计文档草稿并推动实验性实现,并申请了 Go 1.28 的 freeze exception,希望提前约六个月让开发者试用。但该申请尚未获批,功能计划由 GOEXPERIMENT=vetfiles 控制,默认不会影响普通用户的生产行为。

🏷️

标签

➡️

继续阅读