//nolint应置于func关键字所在行末尾以屏蔽整个函数,跨行函数签名时须放在右括号行尾;指定linter需用//nolint:xxx格式,//nolintlint无效。

//nolint 放在函数声明行末尾即可忽略整个函数
直接在 func 关键字所在行末尾加 //nolint,它会作用于该函数体全部内容(包括嵌套的匿名函数),这是最常用、最明确的函数级屏蔽方式。
常见错误是把它写在函数左大括号 { 所在行或函数体第一行——那样只影响那行本身,不会覆盖整个函数。
- ✅ 有效:
func handler(w http.ResponseWriter, r *http.Request) { //nolint - ❌ 无效:
func handler(w http.ResponseWriter, r *http.Request) {//nolint(换行了,只作用于空行) - ❌ 无效:
func handler(w http.ResponseWriter, r *http.Request) {log.Println("start") //nolint(只跳过这一行)
想只忽略特定 linter 就得显式指定,比如 //nolint:unused
函数里可能同时触发多个检查:未使用变量、圈复杂度高、错误未处理……但你往往只想绕过其中一项。这时必须用冒号语法明确限定范围,否则 //nolint 会禁掉所有 linter 对该函数的检查。
例如,一个函数因调用 fmt.Printf 被 staticcheck 报 SA1019(已弃用 API),但其他检查(如 errcheck)仍需保留:
- ✅ 正确:
func legacyLog() { //nolint:staticcheck - ❌ 过度屏蔽:
func legacyLog() { //nolint(unused、gosimple全被关掉) - ✅ 多个 linter:
func initDB() { //nolint:errcheck,goconst
函数签名跨多行时,//nolint 必须紧贴最后一行末尾
Go 允许把参数列表拆成多行,此时注释不能挂在 func 行,而要放在完整签名的末尾——也就是右括号 ) 所在行的行尾。
否则 golangci-lint 无法识别其归属,会静默失效。
- ✅ 有效:
func process(ctx context.Context,input string,opts ...Option) error { //nolint:gomnd - ❌ 无效:
func process( //nolint:gomndctx context.Context,input string)(注释挂在不完整行上)
别和 //nolintlint 混用,它对 golangci-lint 完全无效
有些文档提到 //nolintlint:xxx,那是给单个 linter(如 govet 或 staticcheck)原生命令用的机制。golangci-lint **完全不解析** 这个前缀,写了等于没写。
如果你在函数上写了 //nolintlint:unused 却发现告警还在,不是配置错了,而是根本没被识别——一律换成 //nolint:unused。
反过来,如果项目里混用了两种风格,容易误以为“某个 linter 没生效”,其实是注释类型用错了。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











