//nolint必须紧贴目标语句末尾且在同一行才生效，仅作用于单个语句，需在配置中启用对应linter，语法为//nolint:linter1,linter2（无空格），配置文件须命名正确、缩进合规且被显式加载。
//nolint 必须紧贴代码行末尾，否则完全不生效
加了 //nolint 却还在报错？八成是注释位置错了。它不是普通注释，而是一个**语法级指令**，golangci-lint 只认紧挨着目标语句、且在同一行末尾的写法。
- ✅ 正确：
log.Println("debug") //nolint - ❌ 换行就失效：
log.Println("debug")\n//nolint - ❌ 中间插了别的注释也不行：
log.Println("debug") /* ignore me */ //nolint - ❌ 放在空行或上一行，对下一行无效（除非你明确用
//nolint修饰下一行本身）
特别注意：它只作用于**紧邻的单个语句或声明**，不能跨行、不能隔空、不能“悬停”在 import 块上方想忽略未使用包——那得用 _ 或重构，//nolint 对 import 行无效。
配置文件里必须启用对应 linter，否则 //nolint 被当成普通注释
//nolint 不是万能开关，它只对当前启用的 linter 生效。如果你在配置中禁用了 errcheck，又在某行写了 //nolint 想跳过 errcheck 报错，那它根本不会被解析——因为 errcheck 根本没跑。
- 确认
.golangci.yml的linters.enable列表里包含你想绕过的那个 linter（比如errcheck、staticcheck） - 别依赖默认启用集：golangci-lint 默认只开约 10 个 linter，
staticcheck和unused这类关键检查器默认是关的 - 如果用
disable-all: true+ 手动 enable，更要核对是否漏掉了目标 linter
顺带一提：//nolintlint 是旧写法，golangci-lint **完全不识别**，写了等于白写；统一用 //nolint 即可。
立即学习“go语言免费学习笔记（深入）”；
支持按 linter 类型精确忽略，但语法要写对
想只跳过某一行的 errcheck，而不影响 staticcheck，可以用限定形式：//nolint:errcheck。但它有硬性要求：
- 冒号后**不能有空格**：
//nolint: errcheck❌，//nolint:errcheck✅ - 多个 linter 用逗号分隔，无空格：
//nolint:errcheck,staticcheck - 名字必须和 linter ID 完全一致（大小写敏感），常见 ID 包括：
errcheck、govet、staticcheck、gosimple、unused - 如果配置里把
staticcheck改名叫my-static（通过 alias），那//nolint:staticcheck就不匹配了
这种写法适合临时绕过高置信误报，但别滥用——长期靠它压告警，说明规则或代码本身可能需要调整。
CI 或多 module 环境下，//nolint 生效前提是配置被正确加载
本地测试没问题，CI 里 //nolint 突然失灵？大概率是配置没读到。golangci-lint 不会自动向上递归查找配置，尤其在子 module 或 CI 工作目录非项目根时。
- 确保
.golangci.yml与go.mod同级，且文件名是.golangci.yml（不是.golangci.yaml或golangci.yml） - CI 脚本里别只写
golangci-lint run，显式加上--config=.golangci.yml - 多 module 项目：每个 module 目录下都得有自己的一份
.golangci.yml，父目录的配置不会继承 - 运行命令的工作目录必须是配置文件所在目录，或其子目录（否则找不到配置）
最隐蔽的坑是：配置文件 YAML 缩进错误（比如用 Tab、冒号后少空格、顶层字段缩进不齐），会导致整个配置静默失效，退回到默认启用集——这时 //nolint 只对默认启用的几个 linter 有效，其他全忽略。
