golangci-lint --out-format=json 在 v1.50.0+ 版本才原生支持，低版本会报错；正确用法是 golangci-lint run --out-format=json > report.json，并需加 --issues-exit-code=0 保证 CI 中稳定生成报告。
golangci-lint --out-format=json 不生效？先确认版本支持
低于 v1.50.0 的 golangci-lint 不支持原生 --out-format=json，强行使用会报错 flag provided but not defined: -out-format。v1.50.0+ 才正式引入该参数，且默认输出是终端友好的彩色文本，不是结构化 JSON。
验证方式：golangci-lint --version；若版本偏低，需升级：curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.54.2
正确导出 JSON 报告的两种可靠方式
推荐优先用 --out-format=json（v1.50.0+），它输出标准 JSON 数组，每项是 Issue 对象；若需兼容旧版或定制字段，改用 --print-issued-lines=false --out-format=checkstyle + 外部转换（不推荐，多一步且信息有损）。
-
golangci-lint run --out-format=json > report.json—— 最简路径，注意重定向必须在命令末尾，加2>/dev/null可屏蔽 warning 输出 - 若只想对特定目录扫描并导出：
golangci-lint run ./pkg/... --out-format=json > pkg-report.json - 想包含执行元信息（如时间、配置路径）？原生 JSON 不含这些，得自己 wrap：用
jq拼接：echo '{"timestamp": "'$(date -u +%Y-%m-%dT%H:%M:%SZ)'", "issues": [' > full-report.json && golangci-lint run --out-format=json | sed '$!s/$/,/' >> full-report.json && echo ']}' >> full-report.json
JSON 输出里有哪些关键字段？别误读 line/column
每个 issue 对象含 FromLinter（检查器名）、Text（提示文案）、Pos（位置对象）。重点注意：Pos.Line 和 Pos.Column 是 *字节偏移*，不是 UTF-8 字符位置——若源码含 emoji 或中文，列号可能大于实际可视字符数；VS Code 等编辑器能正确解析，但自行写脚本高亮时需用 utf8.RuneCountInString() 转换。
立即学习“go语言免费学习笔记（深入）”；
常见误判点：Pos.Filename 是相对路径（如 main.go），不是绝对路径；若需绝对路径，得在调用前用 $(pwd) 拼接，或改用 --issues-exit-code=0 配合 go list -f '{{.Dir}}' 获取模块根目录。
CI 场景下怎么让 JSON 报告稳定可用？
CI 中最常踩的坑是退出码和空结果处理：golangci-lint 默认发现 issue 就返回非 0 码，导致 pipeline 中断，无法生成报告。务必加 --issues-exit-code=0 强制成功退出。
- 完整 CI 命令示例：
golangci-lint run --out-format=json --issues-exit-code=0 --timeout=5m > lint-report.json || true - 空报告（无问题）时，输出是空数组
[]，不是 null 或空字符串，解析时需容错 - 若集成 SonarQube，它要求的是
sonarqube格式，不能直接用 JSON；此时必须用--out-format=sonarqube，否则解析失败
真正麻烦的是跨平台路径分隔符——Windows 下 Pos.Filename 含反斜杠 ，而多数静态分析工具只认正斜杠；CI 中统一用 Linux runner，或加 sed 's|\|/|g' 预处理。
