golangci-lint run ./internal/auth 只检查该包路径下合法 Go 包（含子目录），不扫描全项目；需确保路径以 ./ 开头、目录含有效 package 声明，且未被 skip-dirs 或 exclude-rules 过滤。
golangci-lint run 怎么只检查某个包
直接在命令后加包路径即可，golangci-lint run ./internal/auth 会只分析该目录下的 Go 文件（含子目录），不递归扫描整个项目。它默认按 Go 包结构识别，不是简单遍历文件——如果 ./internal/auth 下没有合法的 package 声明，就不会触发任何检查。
常见误区：
- 写成
golangci-lint run internal/auth（缺./）：某些 shell 环境下可能被当作命令参数而非路径，导致静默跳过 - 误用通配符如
golangci-lint run ./.../auth：Go 的...是构建系统语义，golangci-lint不解析它；正确写法是./internal/...表示“internal及其所有子目录” - 路径指向空目录或仅含测试文件（如
_test.go）：若未显式启用tests: true，这些文件会被跳过
.golangci.yml 中如何按包名动态跳过检查
skip-dirs 和 skip-files 是静态路径过滤，无法匹配包名；真正按逻辑包控制范围，得靠 exclude-rules 配合正则匹配 path 字段——因为 golangci-lint 输出的问题里，path 是相对于项目根目录的完整路径，而 Go 包路径（如 github.com/org/repo/internal/auth）通常映射到对应子目录。
例如想跳过所有 internal/ 下的包，但保留 internal/auth：
立即学习“go语言免费学习笔记（深入）”；
issues:
exclude-rules:
- path: "^internal/(?!auth/)"
linters:
- "all"注意点：
-
exclude-rules必须放在issues节点下，写在linters-settings或顶层会完全失效 - 正则中的
^是锚定行首，确保匹配从项目根开始的路径；不加可能误伤cmd/internal这类非目标路径 - 多个
exclude-rules是“依次匹配”，第一条命中即终止，不继续判断后续规则
为什么 go list -f '{{.ImportPath}}' ./... 不能直接喂给 golangci-lint
golangci-lint 不接受 Go 包导入路径（如 github.com/x/y/z）作为输入，只认文件系统路径。即使你用 go list 列出所有包，也得先转成对应目录路径才能用：
golangci-lint run $(go list -f '{{.Dir}}' ./... | grep -v '/vendor/') 但这样有风险：
-
go list输出含构建标签过滤后的包，而golangci-lint默认不读取//go:build，可能导致路径存在但实际无代码可检 - 输出中可能包含生成代码目录（如
pb/），若未在skip-dirs中声明，会触发误报 - 管道方式在 Windows PowerShell 下行为不稳定，建议用 shell 脚本封装或改用
--fix时慎用
IDE（GoLand / VS Code）里包级检查为何常失效
IDE 集成默认只对“当前打开的文件”或“当前模块”做增量检查，不会自动执行 golangci-lint run ./pkg/name。GoLand 尤其明显：即使你配置了 .golangci.yml 并启用了 govet，若没手动在设置里勾选“Analyze whole project”，它就只标红编辑器里正在看的那几个文件。
关键动作：
- GoLand：Settings → Go → Static Analysis → 勾选
Analyze whole project，否则skip-dirs和exclude-rules在 IDE 内基本不生效 - VS Code：确保
"go.lintTool": "golangci-lint"且"go.lintOnSave": "package"，后者才让保存时检查整个包而非单文件 - 两者都依赖
GOPATH和GO111MODULE环境变量与终端一致；IDE 启动方式（如桌面图标双击）常不继承 shell 环境，需改用终端启动goland .或配置环境变量
配置包级检查最易被忽略的点：golangci-lint 本身不理解 Go module 或 import path，所有“包”概念都降维为文件路径操作；任何试图用导入路径做条件判断的配置（比如 if package == "xxx"）都会失败，必须回归到路径字符串和正则。
