golangci-lint 支持5种主流输出格式:colored-line-number(终端默认,带颜色和行号)、json(CI/CD结构化解析)、checkstyle(兼容Jenkins/SonarQube)、github-actions(PR自动标注)、code-climate(适配Code Climate平台),需在output.formats中显式声明并指定path,否则json/checkstyle等会静默丢弃结果。

golangci-lint 输出格式有哪些可选值
golangci-lint 支持 5 种主流输出格式,每种对应不同集成场景,不是所有格式都默认启用,必须显式在 output.formats 中声明:
-
colored-line-number:终端友好,默认颜色高亮 + 行号,适合本地开发时快速定位 -
json:结构化数据,CI/CD 流水线解析告警、入库或做聚合统计的首选 -
checkstyle:兼容 Jenkins、SonarQube 等老牌质量平台,注意路径需为checkstyle.xml才能被识别 -
github-actions:专为 GitHub Actions 设计,自动将问题转为 annotations,直接在 PR 界面标红行 -
code-climate:适配 Code Climate 平台,需配合其 CLI 工具消费
不声明任何 format 时,默认只用 colored-line-number 输出到 stdout;漏配 path 字段会导致 json 或 checkstyle 格式写入失败(报错 open : no such file or directory)。
如何切换日志级别和扫描细节输出
golangci-lint 本身没有传统意义的 “debug/info/warn” 日志级别开关,但可通过以下参数控制扫描过程可见性:
-
--verbose:打印每个 linter 启动耗时、缓存命中状态、跳过文件原因(比如因skip-dirs被忽略) -
--print-issued-lines=true:强制显示触发告警的源码行内容(默认开启,但某些格式如json会自动关闭) -
--print-linter-name=true:在每条告警前加 linter 名称(如staticcheck),方便快速归因 -
--show-stats=true:末尾汇总各 linter 扫描文件数、发现 issue 数、耗时,用于性能基线比对
注意:--verbose 和 --show-stats 不影响输出格式本身,但会额外打印调试信息到 stderr,可能干扰 CI 脚本对 stdout 的解析。
立即学习“go语言免费学习笔记(深入)”;
常见输出格式配置错误
实际配置中容易踩的坑集中在 YAML 结构和路径权限上:
- 多个 format 必须用列表形式,写成
formats: [ {format: json, path: report.json} ],不能省略-或用对象字面量直接嵌套 -
path值必须是相对路径或绝对路径,stdout和stderr是唯一允许的特殊值,其他字符串(如auto、default)会被当作文件名创建,导致权限拒绝或目录不存在错误 - 使用
json格式时若未设path,工具不会报错但静默丢弃全部结果(因为默认输出目标是colored-line-number) -
github-actions格式要求运行环境必须有GITHUB_ACTIONS=true环境变量,否则退化为普通colored-line-number
最稳妥的做法是:CI 中固定用 json 或 github-actions,本地开发保留 colored-line-number;所有 path 都显式写成相对路径(如 report.json),避免依赖当前工作目录意外变更。


















