golangci-lint run默认扫描当前目录但不递归子目录，需用./...显式启用；支持--fix自动修复、--disable/--enable开关linter，推荐通过.golangci.yml精细配置并设timeout防卡死。
要在Go项目中快速执行代码质量检查并精准控制哪些规则生效，必须掌握golangci-lint的run核心命令和linters开关逻辑——直接运行golangci-lint run会启用默认linter集，但若未配置或未忽略测试/生成文件，极易因大量误报中断开发节奏。
基础运行与路径控制
在项目根目录执行最简检查：golangci-lint run。
该命令等价于golangci-lint run ./，但【不会递归扫描子目录】；若要检查所有子包，必须显式写成golangci-lint run ./...。
检查单个文件时路径必须精确到.go后缀，例如golangci-lint run main.go；若传入main或./main会报错“no Go files”。
自动修复与缓存管理
对支持自动修复的linter（如gofmt、goimports），添加--fix参数即可原地修正：golangci-lint run --fix。
缓存机制默认开启，重复运行相同命令时仅分析变更文件。查看当前缓存状态： golangci-lint cache status。
缓存损坏会导致误报或漏报，此时需强制清除：golangci-lint cache clean。注意【此操作不可逆，且下次运行将全量扫描】。
Linters启用与禁用策略
方法一：关闭全部linter再逐个启用
golangci-lint run --disable-all --enable=govet --enable=errcheck
方法二：基于默认集做减法
golangci-lint run --disable=gosimple --disable=unused
方法三：通过配置文件精细控制（推荐长期项目使用）
在项目根目录创建.golangci.yml，写入：
linters: enable: - govet - staticcheck disable: - lll - gocyclo
配置文件方式能避免命令行过长，也便于团队统一规则。若同时存在多个配置文件（如.golangci.yml和.golangci.json），【只读取优先级最高的一个，按文档顺序：.golangci.yml > .golangci.yaml > .golangci.toml > .golangci.json】。
增量扫描与超时控制
第一步：确认当前分支基准点
运行git rev-parse --abbrev-ref HEAD确认当前所在分支（如feature/login）。
第二步：设置对比基准
在.golangci.yml中添加：
run: new-from-rev: origin/main
第三步：执行增量检查golangci-lint run此时只报告从origin/main以来新增或修改的代码中的问题。
大型项目扫描可能卡死，务必设置超时：在配置中加入timeout: 5m，避免CI任务无限挂起。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
