golangci-lint 能检查泛型代码，但需满足四重条件：Go 1.21+、golangci-lint ≥v1.54.2（含 staticcheck v0.15.x）、.golangci.yml 正确配置 linters-settings.staticcheck.enable-all: true 且文件名/路径/缩进无误，并显式禁用已归档的 golint。
golangci-lint 能否检查泛型代码？取决于 Go 版本和 staticcheck 版本
能，但不是默认就开——它依赖底层 linter（主要是 staticcheck）对泛型的解析能力。Go 1.21+ 引入完整泛型支持后，staticcheck v0.14.0+ 才开始逐步覆盖泛型约束、类型推导、实例化错误等场景。如果你用的是 Go 1.22 或 1.23，且 golangci-lint ≥ v1.54.2（对应 staticcheck v0.15.x），泛型相关检查（如 SA1029、SA1030、SA1031）才真正可用。
常见误判：本地 Go 1.23 + golangci-lint v1.52，结果 staticcheck 还是 v0.13.x，泛型误用（比如 type T[U any] struct{} 中 U 未被任何字段使用）完全不报。必须确认二者版本匹配。
- 查
staticcheck版本：golangci-lint run --debug | grep staticcheck - 查 Go 版本：
go version - 升级建议：用官方脚本指定版本安装，例如
curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.55.0
.golangci.yml 中 staticcheck 对泛型的启用要点
只把 staticcheck 加进 linters.enable 不够。它默认关闭部分泛型检查项，需显式开启 linters-settings.staticcheck.enable-all: true，或至少手动启用关键规则：
-
SA1029：泛型参数未被使用（如func F[T any]()中T没出现在函数体或返回值） -
SA1030：泛型约束中~T使用不当（如interface{ ~int | ~string }写成interface{ int | string }） -
SA1031：类型断言在泛型上下文中可能 panic（如v.(T)未加ok判断）
配置示例（注意缩进和冒号后空格）：
立即学习“go语言免费学习笔记（深入）”；
linters-settings:
staticcheck:
enable-all: true
checks:
- "SA1029"
- "SA1030"
- "SA1031"⚠️ 错误写法：linters-settings 缩进多了一格，或写成 linters.settings（少个横线），整个 section 就被忽略，退回到默认禁用状态。
泛型检查失效的三大静默原因
最麻烦的是没报错、也没警告——你以为它在查，其实什么都没做。
-
.golangci.yml文件名错：写成golangci.yml（缺开头点）、.golangci.yaml（后缀不是yml），或放在src/下而非go.mod同级目录 - YAML 缩进混用 Tab 和空格：尤其
linters-settings下的staticcheck块，Tab 会导致解析失败，且golangci-lint不报 YAML 错误，直接跳过 - CI 环境未显式传参：
golangci-lint run在 CI 中找不到配置，退回到默认集（不含泛型检查），必须加--config=.golangci.yml
验证是否生效：在泛型函数里故意写一个未使用类型参数，比如 func Bad[T any](x int) {}，然后运行 golangci-lint run --timeout=30s。有 SA1029 输出才算真启用。
泛型项目中 disable golint 是硬性要求
golint 已归档，不支持泛型语法解析。它遇到 type List[T any] struct{...} 会直接 panic 或静默跳过，还可能误报“泛型名应为大驼峰”这类过时规则。更糟的是，它和 staticcheck 的泛型检查逻辑冲突，导致后者部分规则失效。
配置里必须写死禁用：
linters:
disable:
- "golint"注意："golint" 必须加双引号，大小写敏感；不能写成 golint（无引号）或 Golint（大写）。另外，enable 和 disable 不能共存——选一个策略，推荐只用 enable 显式列表。
泛型检查不是“开了就完事”，它是 Go 版本、linter 版本、YAML 语法、CI 配置四者咬合的结果。任何一个齿松了，整条链就断在静默里。
