golangci-lint 退出码仅用 0 和 1:0 表示成功,1 表示 lint 失败或运行异常;其他非 0/1 值均非其定义,多为 shell 层错误;判断原因需结合输出内容而非仅看 $?。

golangci-lint 本身不定义退出码语义,它完全复用 Go 标准工具链的退出码规范:0 表示成功,非 0 表示失败,具体值无业务含义。
为什么 golangci-lint 没有自定义退出码?
它本质是多个 linter(如 govet、staticcheck、errcheck)的聚合调度器,不参与具体检查逻辑。当任意一个启用的 linter 报错,golangci-lint 就直接返回 1;如果运行过程中发生严重错误(如配置解析失败、无法读取文件),也统一返回 1。它不会像 linear-cli 那样细分“未找到”“认证失败”等场景。
这意味着:
-
golangci-lint的退出码只有两个有效状态:0(全部检查通过)和1(至少一个检查项失败,或运行异常) - 退出码
2、3等在官方文档和源码中均未定义,实际不会出现 - 如果你看到非
0/1退出码,大概率是 shell 层面的问题(例如127表示命令未找到,130是你按了Ctrl-C)
如何判断是 lint 失败还是环境问题?
不能只看 $?,必须结合输出内容判断根本原因:
- 如果终端输出里包含类似
ERROR: failed to load config或open .golangci.yml: no such file,说明是配置或路径问题,属于运行失败,退出码为1,但不是代码质量问题 - 如果输出里有明确的 lint 报告行,例如
main.go:12:3: should omit second argument to copy (S1023),那就是真实代码问题,退出码也是1 - 若命令根本没执行(比如打错了命令名),shell 返回的是
127,和golangci-lint无关
CI/CD 脚本里怎么写才靠谱?
别试图用退出码区分“是 unused 还是 errcheck 报错”,那没意义。重点做两件事:
- 先确保命令能跑起来:
command -v golangci-lint >/dev/null || { echo "golangci-lint not installed"; exit 1; } - 再执行检查,并捕获输出用于调试:
output=$(golangci-lint run 2>&1); exit_code=$?; if [ $exit_code -ne 0 ]; then echo "$output"; exit $exit_code; fi - 如果想跳过某些已知问题,用
--issues-exit-code=0强制成功(慎用),而不是依赖退出码数值
真正容易被忽略的是:golangci-lint 的退出码不反映问题严重程度,也不区分错误类型。它只回答一个问题——“这次检查有没有拦住你?”答案永远只是“是”或“否”。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











