golangci-lint 通过 .golangci.yml 中 run.skip-files 跳过单个 .go 文件，支持正则（如 ^cmd/main.go$）和字面路径（如 internal/cmd/serv.go），路径须相对于项目根目录，匹配成功则文件不参与任何分析。
golangci-lint 怎么跳过单个 .go 文件
直接在 .golangci.yml 里用 run.skip-files，支持正则和字面路径两种写法。它不是“忽略某行”或“压制某条告警”，而是彻底不把匹配的文件交给任何 linter 处理。
-
skip-files是文件级过滤，比//nolint更彻底——后者仍会解析文件、只屏蔽特定检查；前者连 parse 都跳过 - 匹配逻辑是「文件路径（相对于项目根目录）是否满足任一正则」，不是文件名后缀或 basename
- 路径分隔符统一用
/，Windows 下也要写成internal/cmd/serv.go，别用 - 正则以
^开头、$结尾更安全，避免误中（比如serv.go会同时匹配aserv.go和serv.go.bak）
示例配置：
run:
skip-files:
- "^cmd/main.go$"
- "^internal/generated/.*\.go$"
- "mock_.*\.go"
为什么用 skip-files 而不是 exclude-rules
exclude-rules 是针对已触发的 issue 做后置过滤，它先让所有 linter 跑完、再筛掉匹配的报错；而 skip-files 是前置过滤，文件根本不会被加载进分析流水线。
- 性能差异明显：生成代码（如 protobuf、swag、sqlc 输出）通常体积大、语法简单，跳过能省下 20%+ 扫描时间
-
exclude-rules无法屏蔽由 import 引发的跨文件问题（例如 generated/foo.go 导致 main.go 的 unused-import 报错） - 某些 linter（如
govet）对生成代码有特殊 panic 风险，跳过是最稳妥方案
常见错误：路径没生效，还是报错了
最常踩的坑是路径没写对——golangci-lint 匹配的是「从项目根目录开始的完整相对路径」，不是你在 shell 里 pwd 的位置，也不是 go.mod 所在路径的子集。
- 执行
golangci-lint run ./...时，它始终以go.mod所在目录为基准计算路径 - 如果文件在
api/v1/handler/gen.go，配置必须写"^api/v1/handler/gen.go$"，不能只写"gen.go" - 运行命令时加
-v参数（golangci-lint run -v），它会在日志里打印「skipped files」列表，可直接验证是否命中 - 注意：Git 子模块里的
.go文件默认不参与 lint，除非显式用--modules-download-mode=readonly并在配置中放开
生成代码文件要不要跳过？得看来源
不是所有自动生成的文件都该跳过。关键判断点是：这个文件是否会被人手动编辑？是否承担业务逻辑？
- ✅ 应跳过：
pb.go（protoc）、docs.go（swag）、models_gen.go（sqlc）——它们由工具生成，修改即丢失 - ⚠️ 慎跳过：
ent/generated/下的文件（Ent 框架）——虽然生成，但常需 patch 或 hook，部分 linter（如errcheck）仍有价值 - ❌ 不该跳过：
cmd/root.go（Cobra）、internal/config/load.go（自定义 loader）——哪怕带 “gen” 字样，只要人维护，就必须 lint
跳过文件这事本身很简单，难的是判断「该不该跳」。生成代码的边界越来越模糊，比如用 go:generate + 模板写的逻辑层代码，表面是生成的，实际承载核心逻辑——这时候跳过反而掩盖真实缺陷。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
