macOS上启用golangci-lint需先用brew install安装，再将$(brew --prefix)/bin加入PATH并source配置，确保golangci-lint --version可执行；项目中运行golangci-lint run ./...或加--skip-dirs vendor,testdata提速。
在 macOS 上为 Go 项目启用代码质量检查，必须让 golangci-lint 命令全局可用且能正确识别 Go 模块路径，否则运行时会报 command not found 或 exit status 1 —— 这通常不是工具没装好，而是 PATH 或二进制权限出了问题。
用 Homebrew 一键安装并验证
这一步操作起来很简单，直接在终端执行：
brew install golangci-lint
安装完成后立即验证是否生效：
golangci-lint --version
如果输出类似 golangci-lint has version 1.54.2 built from ... 的内容，说明已成功安装。若提示 command not found，请跳转至下一节排查 PATH。
立即学习“go语言免费学习笔记（深入）”；
修复 command not found 错误
Homebrew 安装的二进制默认放在 $(brew --prefix)/bin（Apple Silicon 是 /opt/homebrew/bin，Intel 是 /usr/local/bin），但该路径可能未被 shell 加载。
先确认当前 shell 类型：
echo $SHELL
然后根据结果编辑对应配置文件：
→ zsh 用户编辑 ~/.zshrc，bash 用户编辑 ~/.bash_profile
在文件末尾添加一行：
export PATH="$(brew --prefix)/bin:$PATH"
【务必执行 source 命令使配置立即生效】
zsh 用户运行：source ~/.zshrc；bash 用户运行：source ~/.bash_profile
再运行 which golangci-lint，应返回 /opt/homebrew/bin/golangci-lint（或 /usr/local/bin/golangci-lint）。若仍为空，请检查 brew 是否安装成功：brew doctor。
在项目中首次运行检查
进入任意 Go module 项目根目录（确保有 go.mod 文件）。
方法一：只检查当前目录下所有 .go 文件
golangci-lint run
方法二：递归检查全部子目录（推荐 CI 使用）
golangci-lint run ./...
方法三：跳过 vendor 和 testdata 目录（提速且避免误报）
golangci-lint run --skip-dirs vendor,testdata ./...
第一次运行可能较慢——它会下载并缓存 linters，后续执行将明显加快。若报 undefined: xxx，大概率是 Go module 未正确初始化或 go env GOPATH 与项目路径不匹配，此时先运行 go mod tidy 再重试。
