//nolint 必须紧贴 package 声明前且无空行，才能跳过整个文件；若中间有空行、import 或格式错误（如带空格、大小写错、块注释），则无效；它对未使用 import 不起作用，且仅在 golangci-lint run 扫描到该文件时生效。
直接在文件顶部 package 声明前加 //nolint 即可跳过整个文件，但必须紧贴 package 行、不能换行、不能有空行隔开。
文件顶部 //nolint 必须紧贴 package 声明
它不是注释块，而是 golangci-lint 识别的指令，位置极其敏感：
- ✅ 有效：
//nolint和package main之间**不能有任何空行或其他语句** - ❌ 无效：在
package上方写//nolint，但中间隔了import "fmt"或空行 - ❌ 无效：写成
// nolint（带空格）、//NOINT（大小写错误）或/*nolint*/（块注释） - ⚠️ 注意：
//nolint对import块里的未使用包**不起作用**——想忽略 import，得用_ "xxx"或重构
//nolint 放在文件头和放在函数声明行的区别
作用范围完全不同，别混用：
- 放在
package前：跳过**整个文件**所有 linter 检查（包括 import、变量、函数） - 放在函数声明行末尾：如
func TestFoo(t *testing.T) { //nolint，只跳过该函数体内所有检查 - 放在某一行末尾：如
var unused = 42 //nolint，只跳过该行 - 不支持“跳过从某行开始到文件末尾”这种模糊范围
为什么有时加了 //nolint 还是报错？
常见原因不是配置问题，而是执行环境或路径不对：
- 确认你运行的是
golangci-lint run，不是单独跑go vet或staticcheck——后者完全无视//nolint - 确认文件在扫描路径内：如果用
golangci-lint run ./cmd，而文件在./internal/，那它根本不会被读到 - 确认没被
run.skip-files或run.skip-dirs提前过滤掉（比如配置里写了skip-files: [".*_test\.go"]，那foo_test.go就压根进不了 lint 流程，//nolint自然无从生效） - CI 中常因工作目录错误导致
.golangci.yml未加载，进而回退到默认规则——此时//nolint可能被部分 linter 忽略（尤其旧版本）
最易被忽略的一点：//nolint 是 per-file 的指令，但它依赖于文件被实际送入 linter 流程；如果路径没对上、模块没识别、或配置文件本身失效，它就只是普通注释。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
