golangci-lint配置不生效时会静默回落至默认极简集（仅govet、errcheck等约10个linter），导致无SA1019/unset输出；根本原因常为.golangci.yml文件名错误、未与go.mod同级、缩进含Tab或字段层级错位（如linters-settings嵌套在linters下），且工具不报任何警告。
配置不生效是常态，不是异常；golangci-lint 静默跳过错误配置，不会报错提示。
为什么 golangci-lint run 安静退出、零输出？
它根本没加载你的 .golangci.yml，而是回落到极简默认集（仅 govet、errcheck 等约 10 个），所以你看不到 staticcheck 的 SA1019 或 unused 报告。
- 运行
ls -a确认当前目录同时存在go.mod和.golangci.yml（注意：必须是点开头 +yml小写，不是.yaml、golangci.yml或带 BOM 的文件） - 执行
golangci-lint help linters | grep -E "^(staticcheck|unused|gosimple)"，若无输出，说明配置未生效 - 多 module 项目中，每个含
go.mod的子目录都必须单独放一份.golangci.yml，父目录配置不继承
.golangci.yml 缩进或字段层级错在哪？
YAML 解析失败时，golangci-lint 不会警告，直接弃用整个文件。最常见的是把 linters-settings 或 run 错写成 linters 的子项，或混用 Tab 和空格。
- 所有顶层字段（
run、linters、linters-settings、output）必须顶格、彼此平级，不能缩进 -
linters.enable是列表，每项前必须是-（短横+空格），不能是-或-（多空格） - 用
yamllint .golangci.yml验证基础语法（需提前pip install yamllint） - 复制网上配置时，用
cat -A .golangci.yml检查是否混入不可见字符（如全角空格、Zero Width Space）
升级后 exhaustive 不报错，但代码明显漏分支？
golangci-lint 2.15+ 彻底重构了 exhaustive 配置结构，旧字段名被忽略且不提示——你写的 explicit-exhaustive-switch 已失效。
- 旧写法
explicit-exhaustive-switch: true→ 改为explicit-exhaustive: { check: switch } - 旧写法
ignore-enum-members: ["Unknown"]→ 改为ignore-constants: ["Unknown"]（值必须是字符串切片） -
check必须明确指定为switch、mapliteral或typeswitch，不能写check: true或check: map - CI 中若用了
--fast，exhaustive会被跳过（它属于 slow 分组），本地没开--fast就会看到差异
CI 报 “package xxx not in GOROOT”，但本地正常？
这不是 lint 工具的问题，是 Go 构建环境未就绪——golangci-lint 依赖 go list -json 构建 AST，一旦解析失败，连 cmp、slices 这些标准库包都找不到。
- 检查 CI 中
go version是否 ≥ 1.22（cmp、slog、go/version均由此版本引入） - 确认
GO111MODULE=on已显式设置（CI 默认可能为off） - 确保
go.mod已提交，且没有replace指向 CI 无法访问的本地路径 - CI 脚本中必须先跑
go mod tidy && go build ./，再执行golangci-lint run --config=.golangci.yml
真正麻烦的不是配置写错，而是它从不告诉你哪里错了——所有失效路径都导向同一个安静退出的结果。每次怀疑配置问题，优先验证文件名、位置、缩进这三点，比调参数快得多。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
