macos 配置 go 开发环境需确保 path 正确加载（homebrew 安装需设 /opt/homebrew/bin 或 /usr/local/bin，官方安装为 /usr/local/go/bin）、go111module=on 与 goproxy=https://goproxy.cn,direct 启用模块并加速依赖拉取、gobin 设为 $home/go/bin 并加入 path 以支持 go install 工具全局调用，vs code 需手动配置 go.goroot 和 toolsenvvars 指向对应路径。
macos 上配置 go 开发环境，关键不在“装上就行”，而在于 path 能否被终端正确加载、go modules 是否真正启用、依赖能否稳定拉取。三者任一环节出错，就会出现 command not found: go、go mod download hangs 或 cannot find package "net/http" 这类典型问题。
PATH 设置必须精准匹配实际安装路径
Homebrew 安装的 Go 在 Apple Silicon Mac 上路径是 /opt/homebrew/bin/go，Intel Mac 是 /usr/local/bin/go；官方 .pkg 安装则固定为 /usr/local/go/bin/go。不能只写 export PATH=$PATH:/usr/local/go/bin 就以为万事大吉——如果你用的是 Homebrew，这个路径根本不存在。
确认方式很简单：
- 运行
which go，看输出是什么 - 若为空，说明 PATH 没生效或路径写错
- 若输出
/opt/homebrew/bin/go，就在~/.zshrc中加：export PATH="/opt/homebrew/bin:$PATH" - 改完执行
source ~/.zshrc，再试go version
GOPATH 不再强制，但 GOBIN 和模块代理要显式设好
Go 1.16+ 默认开启模块模式，GOPATH 对项目存放已无影响，但 GOBIN 仍决定 go install 工具（如 gopls、air）装到哪，且必须加入 PATH 才能全局调用。
推荐在 ~/.zshrc 中统一设置：
export GOBIN="$HOME/go/bin"export PATH="$PATH:$GOBIN"-
export GOPROXY=https://goproxy.cn,direct（国内用户必备，避免超时） -
export GO111MODULE=on（确保新项目自动启用模块）
不用再设 GOPATH，除非你维护老项目或想把 go get 包缓存位置固定下来。
依赖管理工具链要按需装配，别全装
日常开发真正高频使用的就三个：
-
golangci-lint：静态检查，集成在 VS Code 保存时触发，命令：brew install golangci-lint -
goimports：自动整理 import 分组与增删，VS Code 的source.organizeImports依赖它：go install golang.org/x/tools/cmd/goimports@latest -
air：热重载，写 Web 服务时省去反复go run：go install github.com/cosmtrek/air@latest
装完记得验证：air -v、goimports -h，确保它们出现在 $GOBIN 下且可执行。
VS Code 需明确告知 Go 工具位置
即使终端里 go 和 gopls 都正常，VS Code 仍可能报“language server not found”。这是因为编辑器不读 shell 的 PATH，得手动指定：
- 打开 VS Code 设置（
Cmd + ,），搜go.goroot，填入/usr/local/go或/opt/homebrew/opt/go/libexec（Homebrew 安装路径） - 搜
go.gopath，可留空（新版扩展已不依赖它） - 搜
toolsEnvVars，点“在 settings.json 中编辑”，添加："GOBIN": "/Users/yourname/go/bin" - 重启 VS Code 窗口，看右下角是否显示
gopls ready
