golangci-lint --version 输出版本信息（如“golangci-lint has version v1.54.2...”）即表示安装成功；若报 command not found 说明未在 PATH 中，permission denied 则需 chmod +x 授予执行权限。
golangci-lint --version 输出什么才算成功
运行 golangci-lint --version 后，如果看到类似 golangci-lint has version v1.54.2 built from 1a2b3c4 on 2026-09-15T10:22:33Z 的输出，说明安装正确、命令可执行。若报错 command not found，说明二进制未在 $PATH 中；若提示 permission denied，常见于 macOS 上从非 Homebrew 方式安装后缺少执行权限（可用 chmod +x $(go env GOPATH)/bin/golangci-lint 修复）。
为什么 golangci-lint version（不带双横线）会失败
golangci-lint version 是无效命令，golangci-lint 不识别 version 子命令。它只接受 --version（两个短横线）这一种形式。这是工具自身 CLI 设计决定的，不是拼写或大小写问题。混淆这点会导致反复验证失败，尤其在 CI 脚本里写错会直接中断流水线。
如何确认当前用的是哪个安装路径的二进制
当 golangci-lint --version 有输出但行为异常（比如配置不生效），很可能是 PATH 中存在多个版本。用以下命令定位真实调用路径：
which golangci-lint
再结合：
ls -l $(which golangci-lint)
常见干扰源包括：
- Homebrew 安装在
/opt/homebrew/bin/golangci-lint（Apple Silicon）或/usr/local/bin/golangci-lint（Intel） - Go install 安装在
$(go env GOPATH)/bin/golangci-lint - 手动下载的二进制可能放在
~/bin/或项目本地./bin/，但没加进 PATH
多个路径共存时，which 返回的第一个才是实际执行的。
CI 环境中版本不一致的典型表现
本地 --version 显示 v1.54.2，CI 流水线却报 unknown flag: --fix 或 invalid configuration key "linters-settings"，基本可断定 CI 使用了旧版（如 v1.42.x）。原因通常是：
- CI 镜像缓存了老版本，未显式更新（
brew upgrade golangci-lint或go install ...@latest缺失） - 使用了固定 tag 的 Docker 镜像（如
golangci/golangci-lint:v1.48），而新配置依赖 v1.50+ 特性 - GitHub Actions 中用了
actions/setup-go但没配golangci-lint版本，靠默认缓存拉取
解决办法：CI 脚本开头强制指定版本安装，例如：
go install github.com/golangci/golangci-lint/cmd/golangci-lint@v1.54.2
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
