golangci-lint默认输出无颜色、无行号、挤成一团，是因为colored-line-number格式仅在TTY终端且支持ANSI时生效；CI或重定向时自动退化为纯文本，需显式配置output.formats并设置print-issued-lines: true等参数才能稳定控制样式。
默认输出为什么没颜色、没行号、还挤成一团
golangci-lint 默认用 colored-line-number 格式，但只在终端支持 ANSI 转义且 stdout 是 TTY 时才生效；CI 环境或重定向到文件时自动退化为纯文本，导致没颜色、没行号、错误信息堆在一行。这不是 bug，是设计行为——它优先保障管道兼容性，而非可读性。
常见现象：golangci-lint run 在本地终端里输出带颜色，但 golangci-lint run > report.txt 后打开全是单行无格式文本；CI 日志里报错只显示 main.go:12:5: xxx，没有上下文代码片段。
- 必须显式配置
output.formats才能稳定控制输出样式，不能依赖默认 -
print-issued-lines: true控制是否展示出问题的那行源码，不设就只报位置不报内容 -
print-linter-name: true让每条提示带上 linter 名（如staticcheck），否则所有警告都长得一样，难定位来源 - 如果想在 CI 中保留颜色（比如 GitHub Actions 的日志高亮），加
FORCE_COLOR=1环境变量，但注意不是所有 CI 都支持
如何让每次运行都固定输出 JSON 供脚本解析
CI 流水线或前端集成需要结构化数据时，json 格式最可靠。但别只写 format: json 就完事——默认 JSON 不含完整元信息，且会把所有 linter 输出混在一起，难做聚合统计。
- 必须配
path: stdout或指定文件路径，否则 JSON 不输出 - 加上
show-stats: true，JSON 里才会包含issues_count、linter_stats等字段 - 若需区分严重级别，启用
severity: "warning"或"error"（需 linter 支持，如staticcheck和govet返回的 severity 字段才有效） - 示例片段：
output:
formats:
- format: json
path: stdout
print-issued-lines: true
show-stats: true忽略某些目录后，输出里还出现 vendor/ 下的路径怎么办
skip-dirs 只影响扫描范围，不影响输出路径显示逻辑。如果 vendor/ 里的代码被其他模块 import 并触发了 unused 或 staticcheck 报错，路径仍会照常打印出来——因为 linter 实际分析的是你项目中引用它的那一层 AST，不是 vendor 文件本身。
立即学习“go语言免费学习笔记（深入）”；
- 真正屏蔽 vendor 路径输出，得配合
exclude-rules正则过滤：path: "^vendor/" - 注意
exclude-rules必须放在issues下级，写在linters-settings里完全无效 - 多个排除条件用列表，每项独立匹配（“或”关系），不是字符串拼接
- 示例：
issues:
exclude-rules:
- path: "^vendor/"
- path: "^testdata/"为什么改了 .golangci.yml 的 output 却没生效
最常见原因是配置文件名或位置不对：.golangci.yml 必须和 go.mod 在同一级目录，且文件名严格为点开头 + yml 小写。写成 .golangci.yaml、golangci.yml 或放在子目录下，golangci-lint 都会静默忽略，退回到默认输出。
- 验证方式：运行
golangci-lint run --debug，看日志里是否打印Configured by指向你的文件 - YAML 缩进必须全用空格，Tab 会导致整个配置失效，且不报错
-
output是顶层字段，和run、linters平级；缩进多一格或少一格，就会变成某个字段的子项而被忽略 - CI 脚本里务必加
--config=.golangci.yml，不能只靠自动发现
关键点在于：输出行为不是“开箱即用”的体验，而是强依赖配置显式声明。最容易被忽略的是 print-issued-lines 和 exclude-rules 的位置约束——它们不起作用，往往不是参数写错，而是 YAML 结构塌陷了。
