go命令未找到需检查安装与环境变量：一、用.pkg安装自动配置路径；二、homebrew安装便于管理；三、手动解压可精确控版本；四、必须配置gopath和path；五、国内需设goproxy代理。
如果您在Mac上尝试运行Go程序但终端提示“command not found: go”，则可能是Go二进制未被系统识别，或环境变量未正确加载。以下是解决此问题的步骤：
一、通过官方 .pkg 安装包安装 Go
该方式提供图形化向导，自动将 /usr/local/go/bin 写入系统路径（仅对新终端生效），适合初学者且避免 Shell 配置误操作。
1、访问 Go 官方中文下载页 https://golang.google.cn/dl/ 或清华大学镜像站 https://mirrors.tuna.tsinghua.edu.cn/golang/。
2、根据芯片架构选择对应安装包：Apple Silicon（M1/M2/M3）选 darwin-arm64.pkg；Intel 芯片选 darwin-amd64.pkg。
3、双击下载的 .pkg 文件，全程点击“继续”完成安装。
4、打开**全新终端窗口**，执行 go version；若输出类似 go version go1.22.6 darwin/arm64，说明安装成功。
二、使用 Homebrew 安装 Go
该方式便于后续统一管理工具链，适合已配置 Homebrew 的用户；Homebrew 会将 Go 二进制软链接至 /opt/homebrew/bin/go（Apple Silicon）或 /usr/local/bin/go（Intel），并自动纳入 PATH。
1、若未安装 Homebrew，先在终端运行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
2、执行安装命令：brew install go。
3、验证安装：go version 应返回有效版本信息；再执行 which go 确认路径为 Homebrew 管理目录。
三、手动解压官方 tar.gz 包安装
该方式完全绕过包管理器，可精确控制版本（如必须使用 go1.21.6）、规避 Perl/Python 依赖冲突，且不修改系统默认 Go 链接。
1、前往 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载对应架构的 goX.Y.Z.darwin-arm64.tar.gz 或 goX.Y.Z.darwin-amd64.tar.gz。
2、在终端执行：sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf ~/Downloads/go*.tar.gz。
3、验证：go version 输出应匹配所下载版本号及芯片架构。
四、配置 GOPATH 和 PATH 环境变量
无论采用哪种安装方式，都必须确保 $GOROOT/bin（Go 运行时）和 $GOPATH/bin（Go 工具生成路径）均在当前 Shell 的 PATH 中，否则 go install 生成的命令无法全局调用。
1、确认当前 Shell 类型：echo $SHELL；若输出 /bin/zsh，则编辑 ~/.zshrc；若为 /bin/bash，则编辑 ~/.bash_profile。
2、使用 nano 编辑配置文件：nano ~/.zshrc，在末尾追加以下三行：
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
export PATH=/usr/local/go/bin:$PATH
3、保存后立即重载：source ~/.zshrc（或对应配置文件）。
4、验证 PATH 是否生效：echo $PATH | grep "local/go/bin" 和 echo $PATH | grep "go/bin" 均应有输出。
五、配置 GOPROXY 并验证模块可用性
国内用户不配置代理将导致 go mod download 或 go get 卡死于 GitHub 依赖拉取，这是环境“看似安装成功却无法开发”的最常见原因。
1、设置国内可信代理：go env -w GOPROXY=https://goproxy.cn,direct。
2、关闭校验以避免证书问题：go env -w GOSUMDB=off。
3、创建测试项目验证闭环：
mkdir ~/test-go && cd ~/test-go
go mod init example.com/test
go run
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
