必须先满足Go 1.21+版本、正确配置GOROOT/GOPATH/GOBIN环境变量、安装make/git/curl等基础工具，否则golangci-lint无法成功安装或运行。
要在本地成功安装并运行golangci-lint，必须先确保Go工具链版本匹配、环境变量配置正确、构建依赖就绪，否则后续所有安装命令都会失败或产生不可预测行为。
确认Go版本是否满足最低要求
打开终端，执行：go version。golangci-lint 当前（2026年10月）主干分支要求 Go 1.21+，低于该版本将无法编译或运行部分linter插件。
若输出为 go version go1.20.15 darwin/amd64 或更低，请升级Go——旧版不支持泛型深度检查、embed语法校验等关键能力，会导致 golangci-lint 启动即 panic。
升级方式：前往 https://go.dev/dl/ 下载对应平台的最新稳定版安装包，或使用 go install golang.org/dl/go1.22@latest && go1.22 download 快速切换验证。
立即学习“go语言免费学习笔记（深入）”；
检查并配置关键环境变量
运行 go env GOPATH GOROOT GOBIN，确认三项均非空且路径合理。
【GOROOT 必须指向 Go 安装根目录，不能是软链接或用户家目录下的副本】。常见错误是手动解压 Go 到 ~/go 并设为 GOROOT，这会导致 go install 生成的二进制无法被系统识别。
GOPATH 建议保留默认值（如 $HOME/go），GOBIN 应显式设为 $GOPATH/bin 并加入 $PATH——否则 go install 安装的 golangci-lint 将找不到可执行文件。
在 shell 配置中追加（以 zsh 为例）：export PATH="$GOPATH/bin:$PATH"，然后执行 source ~/.zshrc 生效。
验证构建基础工具链是否完备
golangci-lint 的 Makefile 依赖 make、git、curl 和标准 Unix 工具（如 sed、awk）。
依次执行以下命令，任一失败需立即补全：
which make git curl sed awk
macOS 用户若未安装 Xcode Command Line Tools，运行 xcode-select --install；Linux 用户用 sudo apt install build-essential（Debian/Ubuntu）或 sudo dnf groupinstall "Development Tools"（Fedora）。
这一步操作起来很简单，直接把文件拖进去就行——但若跳过，后续 make install 会卡在 clone 子模块或生成文档阶段，报错信息不提示缺失工具，只显示 “No rule to make target”。
