golangci-lint 默认只扫描当前工作目录及子目录,要只扫某个子目录,应在该目录下执行 golangci-lint run,或显式传入路径如 golangci-lint run cmd/myapp/...(含子包)或 golangci-lint run ./cmd/myapp(仅本包)。

golangci-lint 怎么只扫某个子目录?
直接在目标目录下运行 golangci-lint run 就行,它默认只检查当前目录及子目录下的 Go 文件。但要注意:它**不会自动识别你“想扫的路径”**,而是按当前工作目录 + .golangci.yml 中的 run.skip-dirs / issues.exclude-rules 等配置共同决定范围。
常见错误是人在项目根目录执行命令,却期望只扫 cmd/myapp —— 结果扫了整个 ./...。解决办法很简单:
- cd 进目标目录再运行,比如
cd cmd/myapp && golangci-lint run - 或用
--path-prefix配合--skip-dirs(不推荐,易错) - 更稳妥的是显式传入路径参数:
golangci-lint run cmd/myapp/...或golangci-lint run ./cmd/myapp
注意:... 是 Go 的通配语法,表示该目录下所有子包(含嵌套),而 ./cmd/myapp 只扫该包本身(不含子目录)。实际中多数人需要前者。
为什么加了 --skip-dirs 还在扫 vendor?
golangci-lint 默认跳过 vendor、testdata、examples 等目录,但这个行为受两个因素干扰:一是你本地配置文件里是否显式清空了默认跳过项,二是 CLI 参数优先级高于配置文件。
立即学习“go语言免费学习笔记(深入)”;
如果你在 .golangci.yml 里写了 run.skip-dirs: [],那就等于关掉了所有默认跳过——vendor 就会进扫描。修复方式:
- 删掉
run.skip-dirs: [],让默认值生效 - 或者显式保留:
run.skip-dirs: ["vendor", "testdata", "examples"] - 命令行临时跳过:
golangci-lint run --skip-dirs=vendor,generated(注意逗号分隔,无空格)
另外,vendor 被扫还可能因为用了 go mod vendor 后又手动改过 vendor/ 内容,导致 lint 认为它是“源码一部分”——这种情况建议统一用 go list -f '{{.Dir}}' ./... 检查实际参与构建的路径,再针对性过滤。
golangci-lint run ./pkg/... 报 “no go files” 怎么办?
这不是路径写错了,而是 golangci-lint 在解析 ./pkg/... 时,先调用 go list 获取包列表,而 go list ./pkg/... 要求 ./pkg 下至少有一个 go.mod 或能被 go 工具链识别为有效模块/包的结构。常见断点:
-
./pkg是空目录,或只有非.go文件 -
./pkg下没有go.mod,且父目录的go.mod没把pkg当作子模块(比如没 import 过) - 目录名含非法字符(如空格、中文),导致
go list解析失败(错误信息通常是invalid pattern)
验证方法:先手动跑 go list ./pkg/...,看是否输出包路径。如果没输出,golangci-lint 必然也扫不到——得先确保 Go 工具链能识别这个路径。
CI 中限定路径扫描要注意什么?
CI 脚本里常用 git diff --name-only origin/main...HEAD -- '*.go' 获取变更文件,再提取目录去扫。这里最容易被忽略的是路径归一化问题:
- Git 输出的是相对路径(如
pkg/http/server.go),但golangci-lint run pkg/http和golangci-lint run ./pkg/http行为一致;而golangci-lint run pkg/http/...才包含子包 - 多个变更文件可能属于同一目录,重复扫描浪费时间,建议用
dirname+sort -u去重 - 如果变更涉及
go.mod,要额外扫根目录,否则依赖变更引发的 lint 问题(如未使用的导入)可能漏掉
一个轻量级做法:git diff --name-only origin/main...HEAD -- '*.go' | xargs -r dirname | sort -u | xargs -r -I{} golangci-lint run {}/...。但注意 xargs 在空输入时不报错也不执行,需前置判断。
路径限定看着简单,真正稳定落地要同时对齐 Go 工具链行为、配置文件语义和 CI 环境路径状态——三者稍有不一致,结果就不可控。


















