go命令报“command not found”的根本原因是goroot和path未对齐，需确保path包含$goroot/bin（如/usr/local/go/bin），并根据shell类型（zsh/bash/windows）正确配置后source或重启终端验证。
Go 环境装不上、go 命令报 command not found、go get 卡住或失败、GO111MODULE=on 下项目编译不通过——这些问题不是你手生，而是环境变量、模块模式、安装路径三者没对齐。核心判断就一条：GOROOT 和 PATH 必须指向同一个 go 二进制文件，且 GOPATH 在模块模式下仅影响 go install 的默认输出位置。
为什么 go version 找不到命令？
这是 macOS 和 Linux 用户最常遇到的第一道坎，本质是系统根本不知道 go 在哪。Homebrew 安装的 go 默认软链到 /usr/local/bin/go，但这个路径不一定在你的 PATH 里；手动安装的则更常见：解压完放在 /home/xxx/go 或 /usr/local/go，却忘了把 $GOROOT/bin 加进 PATH。
- 先查真实路径：
which go返回空？说明 PATH 没配对；返回/opt/homebrew/bin/go（Apple Silicon Mac）或/usr/local/bin/go（Intel Mac / Linux），就以此为准反推GOROOT - Mac 用户注意 shell 类型：Zsh（默认）改
~/.zshrc，Bash 改~/.bash_profile；加这行：export PATH=$PATH:/usr/local/go/bin（路径按which go输出调整） - Windows 用户如果没勾选安装时的
Add Go to PATH，就得手动进「系统属性 → 高级 → 环境变量」，在用户或系统 PATH 里新增C:\Go\bin - 改完别忘
source ~/.zshrc（Mac/Linux）或重启终端（Windows），再跑go version验证
GO111MODULE=on 时为什么 go get 还报错？
模块模式开启后，go get 不再往 $GOPATH/src 写代码，而是下载到 $GOPATH/pkg/mod 并写入 go.mod。但很多人卡在“明明开了模块，却提示找不到包”，其实是两个隐形前提没满足：
- 当前目录必须有
go.mod文件（用go mod init myproject初始化），否则go get会拒绝执行（GO111MODULE=on下的严格行为） - 国内网络直连
golang.org/x/...会超时，必须配代理：go env -w GOPROXY=https://goproxy.cn,direct（推荐goproxy.cn或https://goproxy.io） - 如果项目里已有旧的
vendor目录，go get可能被干扰，建议先rm -rf vendor再试 - 遇到
missing go.sum entry，不是错误而是提示，运行go mod download+go mod tidy就能补全
GOPATH 还需要手动设吗？
Go 1.16+ 默认启用模块，GOPATH 对日常构建、运行已无强制作用——go run、go build 全部基于当前模块根目录。但它仍控制两件事：go install 编译后的二进制放哪，以及 go get 下载的 module cache 存哪（$GOPATH/pkg/mod）。
- 不设
GOPATH？可以，Go 会 fallback 到$HOME/go，但路径含空格或中文会出问题（比如/Users/张三/go） - 设了但没建目录？
go install会静默失败，不报错也不生成可执行文件，排查时容易漏掉 - 正确姿势：
go env -w GOPATH=$HOME/mygopath，然后mkdir -p $HOME/mygopath/{bin,pkg,src}（src现在基本不用，但留着不碍事） - 特别提醒：Battery Historian 2.0 等老项目仍依赖
$GOPATH/src/github.com/...目录结构，此时GOPATH不仅要设，还得把源码放对位置
真正容易被忽略的点是：不同安装方式（Homebrew / pkg / tar.gz）可能留下多个 go 二进制，which go 和 go env GOROOT 输出不一致时，go 命令实际运行的是前者，而 go build 用的是后者——这种错位会导致 CGO_ENABLED=0 编译失败、交叉编译链路断裂等疑难问题。动手前，先清干净旧版本，再统一用一种方式重装，比反复调参高效得多。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
