可通过 .golangci.yml 的 linters-settings 自定义各检查器行为：如 errcheck 启用类型断言/禁止 _ 忽略 error、gocyclo 调低圈复杂度阈值、revive 指定规则文件、govet 禁用特定子检查。
为具体检查器设置行为参数
当 golangci-lint 默认检查逻辑不符合团队规范时，必须通过 linters-settings 区块定制每个 linter 的内部行为，比如让 errcheck 报告类型断言错误、让 gocyclo 将圈复杂度阈值调低到 10。
在项目根目录的 .golangci.yml 文件中，添加 linters-settings 顶层字段，其下按 linter 名称组织子项，每个子项内写入该工具原生支持的配置键值对。
这一步操作起来很简单，直接把配置块粘贴进 YAML 文件对应位置即可，但注意缩进必须用空格且层级对齐，否则解析失败会导致整个配置被忽略。
控制 errcheck 检查哪些错误场景
errcheck 默认只检查函数返回 error 后完全未处理的情况，但团队可能要求更严格：比如强制检查类型断言是否带第二个 error 参数，或禁止用 _ 忽略 error 赋值。
立即学习“go语言免费学习笔记（深入）”；
方法一：启用类型断言检查
在 linters-settings.errcheck 下添加 check-type-assertions: true，这样 v, _ := m["key"].(string) 会被标记——因为缺少 ok 判断，无法安全处理断言失败。
方法二：禁止空白标识符接收 error
添加 check-blank: true，此时 _, err := strconv.Atoi(s) 会触发告警。⚠️ 注意：开启后需同步清理历史代码中所有此类写法，否则 CI 直接失败。
方法三：组合使用两项
同时设置 check-type-assertions: true 和 check-blank: true，覆盖最严苛的错误处理要求。这是金融类项目常用配置，能显著降低运行时 panic 风险。
调整 gocyclo 圈复杂度阈值
gocyclo 用于检测函数逻辑分支过多的问题，原始默认阈值是 30，对 Go 项目来说过高，容易漏掉真正臃肿的函数。
第一步：确认当前项目接受的最高复杂度
先运行一次 golangci-lint run --out-format=tab | grep gocyclo，观察高频报错值，取其 80% 分位数作为新阈值（例如多数报错在 12～18，则设为 15）。
第二步：修改配置
在 linters-settings.gocyclo 下写入 min-complexity: 15。这个数字越小越敏感，设为 10 会把很多 HTTP handler 函数标红，需谨慎评估。
第三步：验证效果
执行 golangci-lint run --fast（跳过缓存），确认新增的高亮是否符合预期。若误报严重，说明阈值过低，需回调 2～3 点再试。
配置 revive 自定义规则集
revive 是可编程的 linter，支持通过 YAML 规则文件启用/禁用具体检查项，比如关闭 var-naming 但保留 deep-exit。
创建 .revive.toml 文件，内容示例：severity = "warning"<br>confidence = 0.8<br>[rule.var-naming]<br>disabled = true<br>[rule.deep-exit]<br>disabled = false
在 .golangci.yml 中指向该文件：linters-settings:<br>
revive:<br>
config: ".revive.toml"
【config 路径必须是相对于 .golangci.yml 的相对路径】 若填绝对路径或 ../ 会静默失效，且不报错。
禁用 govet 特定子检查
govet 自带大量子检查（如 printf、fieldalignment），但某些子项与团队技术栈冲突，比如 shadow 在使用泛型时频繁误报。
在 linters-settings.govet 下使用 disable 列表：disable:<br>
- "shadow"<br>
- "printf"
注意不要写 enable-all: true 再单独关几个——这会激活所有 govett 子检查，包括已废弃的 atomic，导致分析失败。
