配置文件无version字段，所谓“版本错误”实为工具版本与配置语法或启用规则不兼容所致；需删除非法version行、验证YAML语法、核对linters是否被当前版本支持，并统一CI与本地的Go及golangci-lint版本。
配置文件本身没有版本号字段，所谓“版本错误”实际是工具版本与配置语法、启用规则不兼容导致的解析失败或行为异常。
检查 .golangci.yml 是否含非法字段或过时语法
golangci-lint 不校验配置文件里的 version 字段（它根本不存在），但老项目常误加 version: 1 或 version: "2" 这类无效项，会导致启动报错：yaml: unmarshal errors... unknown field "version"。
- 删掉配置顶部任何形如
version:的行 - 确认顶层结构只有
run、linters、linters-settings、issues等官方支持的 key - 用
yamllint或 VS Code YAML 插件验证基础语法，避免缩进错位或冒号后缺空格
启用的 linter 在当前 golangci-lint 版本中是否已被移除或重命名
比如 v1.50.0 移除了 goconst（由 staticcheck 覆盖），若配置里仍写 - goconst，工具会静默跳过——你以为开了，其实没生效；而 v2.14.0 重新启用了 gosec 的 G407 规则，若旧配置里禁用了整个 gosec，那这条检查也不会出现。
- 运行
golangci-lint help linters查看当前版本实际支持的 linter 列表 - 对比配置中
linters.enable里的名字是否全在输出列表中 - 对不确定的 linter，临时注释掉，再跑一次
golangci-lint run --no-config看默认启用哪些，作为基线参考
CI 中提示 “undefined: xxx” 却本地正常，本质是 Go module 解析环境不一致
这不是配置文件错误，但常被误认为“配置版本问题”。典型现象：CI 报一堆类型未定义，而 .golangci.yml 里明明写了 run.modules-download-mode: readonly。
立即学习“go语言免费学习笔记（深入）”；
- 确认 CI 使用的 Go 版本 ≥ 1.16，并显式设置
GO111MODULE=on - 检查
go.mod是否提交，特别是replace指向本地路径的行——CI 拉不到，linter 就无法解析依赖 - 在 CI 步骤中加一行
go list -m all，验证模块能正常 resolve；失败则golangci-lint必定报 undefined
真正容易被忽略的是：golangci-lint 的行为会随 Go SDK 版本漂移。比如 staticcheck 在 Go 1.22 下对泛型的检查比 1.21 更激进，即使配置完全一样，告警数量也可能突增——别只盯着配置文件，得锁死 Go 和 golangci-lint 两个版本。
