验证.golangci.yml需三步：先用golangci-lint config verify检查YAML语法；再用golangci-lint linters确认启用的linter是否真实生效；最后用golangci-lint run --config=.golangci.yml测试检查效果，并通过config print排查CI中配置未加载问题。
当你修改完.golangci.yml配置文件却不确定它是否语法正确、能否被golangci-lint识别时，直接跑run命令可能报错模糊、定位困难，甚至因配置无效导致检查静默失效。
验证配置文件语法是否合法
在项目根目录（即与go.mod同级）执行：
golangci-lint config verify
该命令仅解析.golangci.yml的YAML结构和基础字段，不加载任何linter，也不读取代码。若输出Config is valid，说明格式无硬性错误；若报yaml: unmarshal errors或unknown field，则需修正对应行。
立即学习“go语言免费学习笔记（深入）”；
注意：.golangci.yml必须是标准YAML——缩进用空格（不能用Tab），布尔值写true/false而非True/False，列表项前加-且后跟空格。
确认配置中启用的linter真实可用
运行以下命令检查当前配置实际启用了哪些linter：
golangci-lint linters
输出会列出所有已启用的linter名称及其状态（enabled/disabled）。如果某个你写在enable列表里的名字没出现，说明它被其他规则隐式禁用，或拼写错误（比如把staticcheck写成static-check）。
这一步能暴露配置中“看似启用实则未生效”的陷阱——例如误将govet写成go-vet，golangci-lint不会报错，但该检查器完全不会运行。
测试配置是否能正确加载并触发检查
方法一：用--no-config跳过配置，强制走默认规则，对比行为差异
golangci-lint run --no-config --out-format=tab → 得到默认启用的govet、errcheck等结果
golangci-lint run --config=.golangci.yml --out-format=tab → 得到你配置的实际结果
若后者结果条目明显少于前者，大概率是配置中enable列表为空、路径错误，或.golangci.yml不在go.mod同级目录。
方法二：对单个测试文件快速验证
新建一个故意违规的.go文件（如定义未使用的变量），然后执行：
golangci-lint run --config=.golangci.yml --fast ./testfile.go
如果预期的linter（如unused）没报错，而golangci-lint linters里又显示它已启用，就要检查该linter是否依赖Go版本（如staticcheck在Go 1.22+才支持某些泛型检查）或是否被run.skip-dirs意外排除了当前路径。
排查CI中配置不生效的典型路径
第一步：确认CI工作目录下存在.go.mod文件，且.golangci.yml与其在同一目录
第二步：在CI脚本中显式指定配置路径，禁止依赖自动发现：
golangci-lint run --config=.golangci.yml --timeout=3m
第三步：添加调试输出，验证配置是否被读取：
golangci-lint config print → 直接打印最终生效的完整配置内容，包括继承合并后的结果
如果config print输出为空或只有默认字段，说明--config参数路径错误、文件权限不足（如CI中chmod 600导致不可读），或文件编码含BOM头（Windows生成的UTF-8 BOM会导致YAML解析失败）。
第四步：检查多module项目是否遗漏子module配置——每个go.mod所在目录都必须有独立的.golangci.yml，父目录的配置不会向下传递。
