golangci-lint通过.golangci.yml中run.skip-files精准忽略单个文件，需写完整相对路径（如- internal/cmd/cmd_serv.go），不支持正则仅后缀匹配，注意YAML格式、配置位置及CI参数。
golangci-lint怎么用skip-files忽略单个文件
直接在.golangci.yml里配run.skip-files，它支持通配符和精确路径匹配，但注意：只对文件名或路径后缀生效，不支持正则。
-
skip-files是路径后缀匹配，比如写- serv.go会跳过cmd/serv.go、internal/handler/serv.go甚至myserver.go（因为后缀含serv.go） - 要精准排除某个具体文件，写完整相对路径，如
- internal/cmd/cmd_serv.go（相对于配置文件所在目录） - 不能写绝对路径或带
./前缀，./internal/cmd/cmd_serv.go会被当成字面字符串匹配失败 - 多个文件用列表形式，每行一个，别用逗号分隔
为什么skip-files没生效？常见失效原因
不是配置写错了，而是匹配逻辑被误读。golangci-lint的skip-files不看文件内容、不走glob展开，纯靠字符串后缀比对。
- 写了
- docs/doc.go但实际生成路径是docs/docs.go→ 不匹配，得改成- docs.go或- /docs.go（后者更稳妥） - 用了Tab缩进或冒号后少空格 → YAML解析失败，整个
run块被忽略，退回到默认行为 - 配置文件放在子目录（如
api/.golangci.yml），但go.mod在上层 → 它根本不会加载这个配置 - CI中没加
--config=.golangci.yml参数 → 自动发现机制只在当前目录找，不会向上递归
skip-dirs和skip-files该选哪个？
优先用skip-dirs，除非你明确只需要跳过个别文件而非整个目录。
-
skip-dirs: [vendor, docs, testdata]整目录屏蔽，性能好、语义清晰、能跳过目录下所有衍生文件（包括_test.go、generated.go） -
skip-files适合临时绕过单个“坏文件”，比如某份手写的mock_*.go因结构特殊老是触发unused误报 - 两者可共存，但
skip-dirs优先级更高：如果foo/在skip-dirs里，foo/bar.go哪怕没列在skip-files也照样被跳过 - 别混用
exclude-rules来干skip-files的活——那是按问题文本过滤，不是按文件路径
排除第三方生成代码的实操建议
像pb.go、mock_*.go、swag/docs.go这类文件，靠skip-files容易漏，推荐组合策略：
- 把生成目录加进
skip-dirs：- internal/gen、- api/pb、- docs - 对零星漏网的文件，用
skip-files兜底：- mock_server.go - 如果生成文件分散且命名无规律，改用
exclude-rules按路径正则过滤（放在issues.exclude下）：path: ".*mock.*\.go$" - 永远不要在生成文件里加
//nolint——下次protoc重跑就没了
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
