golangci-lint 安装后 command not found 是因未加入 $PATH；macOS/Linux 需将 $HOME/go/bin 加入 ~/.zshrc 或 ~/.bashrc，Windows 需手动添加 %USERPROFILE%\go\bin 到系统 Path。
golangci-lint 安装后运行报 command not found 怎么办
安装完没进 $PATH，是新手最常卡住的第一步。macOS/Linux 用 curl 或 go install 装的二进制默认不在系统路径里，Windows 则容易漏掉环境变量配置。
- Linux/macOS：确认安装路径（比如
$HOME/go/bin），把它加进$PATH—— 编辑~/.bashrc或~/.zshrc，追加export PATH=$HOME/go/bin:$PATH，然后source一下 - Windows：用
go install装的会放在%USERPROFILE%\go\bin，需手动加到系统环境变量Path中 - 验证方式不是只看
which golangci-lint，还要跑golangci-lint --version确保能执行
项目根目录下没有 .golangci.yml 就没法检查？
不是必须。golangci-lint 会按顺序查找配置文件，但默认行为其实很“宽松”：没配就用内置默认规则集，只启用约 10 个基础 linter（如 govet、errcheck），大量常用检查（比如 goconst、gocyclo）根本不会触发。
- 建议从官方推荐模板起步：
golangci-lint config init生成最小可用.golangci.yml - 别直接复制网上“全量开启”的配置——部分 linter（如
gosimple）和新版 Go 不兼容，会导致panic: interface conversion - 如果只想临时启用某个检查，用命令行参数更轻量：
golangci-lint run --enable=bodyclose
CI 流水线里 golangci-lint run 突然失败，本地却正常
大概率是 Go 版本或模块模式不一致。golangci-lint 的 linter 本身依赖 Go 的 AST 和类型信息，不同 Go 版本间 go/types 行为有差异，尤其在泛型解析上。
- CI 中显式指定 Go 版本（如 GitHub Actions 用
actions/setup-go@v4），并确保和本地开发版本一致（go version对齐） - 检查
GO111MODULE：CI 默认可能关模块，导致go list -deps解析失败，报错类似can't load package: package xxx is not in GOROOT—— 统一设为on - 避免在 CI 中用
--fast：它跳过某些 linter 的 type-check 阶段，本地开、CI 关，行为不一致
为什么 golangci-lint run ./... 比 ./... 慢很多甚至卡住
根本原因是 ./... 会让 golangci-lint 递归扫描所有子目录，包括 vendor/、node_modules/、生成代码目录（如 pb/），而多数 linter 并不擅长跳过非 Go 文件或大体积第三方包。
立即学习“go语言免费学习笔记（深入）”；
- 明确限定范围：
golangci-lint run ./pkg/... ./cmd/...，避开vendor/和测试数据目录 - 在
.golangci.yml中用skip-dirs或skip-files硬性排除，比如skip-dirs: ["vendor", "third_party"] - 注意
run子命令的-j（并发数）默认是 CPU 核心数，但某些 linter（如staticcheck）内存占用高，多开反而 OOM —— CI 中建议设-j 2
配置真正生效前，先用 golangci-lint run --debug 看它实际加载了哪些 linter、扫描了哪些路径——很多“奇怪行为”都源于预期和实际执行范围不一致。
