GitHub Actions中golangci-lint不标红，是因为默认终端输出格式无法被解析，必须显式指定--out-format=github-actions参数，且需配合--config=.golangci.yml和正确环境（GO111MODULE=on、Go 1.21+、v1.54+版本）才能生效。
预合并检查（pre-merge check）里 golangci-lint 失效，90% 是配置没被加载或输出不匹配 CI 环境——不是工具不行，是它默认只对人友好，不对机器友好。
为什么 GitHub Actions 里不报错但也不标红？
golangci-lint 默认输出带颜色的终端文本，GitHub Actions 完全无法解析，也就不会在 PR 中标记问题行。它安静地跑完了，但 CI 认为“没问题”，实际漏检严重。
- 必须显式指定
--out-format=github-actions，这是唯一能让 GitHub 自动注释问题行的格式 - 不能写成
output.formats: [{format: github-actions}]放在.golangci.yml里——CI 脚本中未传--config参数时，该配置根本不会生效 - 如果用了
--fix，确保对应 linter 支持自动修复（如gofumpt、revive），staticcheck和goconst不支持 fix，强行加会静默跳过
本地能过、CI 报一堆 SA1019 怎么办？
SA1019 是 staticcheck 报的“使用了已弃用 API”警告，CI 突然狂报而本地安静，基本不是代码问题，而是环境三件套不一致：
-
GO111MODULE：CI 镜像常默认为off，导致go list -deps解析失败，linter 降级运行或误判；应在 CI 脚本开头加export GO111MODULE=on - Go 版本：2026 年主流项目已用 Go 1.21+，旧版 golangci-lint（如 v1.42.x）无法正确分析泛型，必须升到
v1.54+；CI 中建议固定版本：golangci-lint@v1.54.2 - 模块路径：CI 执行目录若不在
go.mod同级，.golangci.yml不会被自动发现；务必显式传参：golangci-lint run --config=.golangci.yml
怎么让 pre-merge 检查真正卡住有问题的 PR？
关键不是“有没有报错”，而是“有没有让 CI 明确失败”。很多配置看似完整，却因退出码或阈值设置失效：
立即学习“go语言免费学习笔记（深入）”；
-
issues.max-issues-per-linter: 0：设为0表示不限制条数，避免 staticcheck 查出 57 个问题只报前 50 个 -
issues.max-same-issues: 0：关掉合并，防止同一类错误（如多次漏defer resp.Body.Close()）被折叠成一条，掩盖真实频次 - CI 脚本末尾必须检查退出码：
if [ $? -ne 0 ]; then exit 1; fi，不能依赖命令本身中断流程——某些旧版 runner 会吞掉非零退出码 - 别信
run.timeout: 5m配置：CI 容器资源受限时，超时由 runner 控制，golangci-lint内部 timeout 只影响单次分析，建议在 CI 步骤级设timeout-minutes: 3
最易被忽略的是：预合并检查不是越严越好，而是要和团队当前能力匹配。比如刚启用时先只开 govet、errcheck、staticcheck 三个，等 CI 稳定、成员习惯修复节奏后，再加 goconst 或 gosimple。否则大量历史技术债会直接阻塞所有 PR，最后只能关掉检查——配置本身没错，错在没分阶段落地。
