go命令找不到是path未配置所致，需手动添加go安装路径到环境变量，并避免错误设置goroot、gobin、gopath和gocache，模块名须用标准虚拟路径格式。
go命令找不到，八成是PATH没配对
这不是Go没装好，而是shell根本不知道go在哪。Mac/Linux下Homebrew装的go在/opt/homebrew/bin/go（Apple Silicon）或/usr/local/bin/go（Intel），但brew不自动加PATH；手动解压的Go默认在/usr/local/go/bin/go，同样不在系统默认路径里。
实操建议：
- 先确认go真实位置：
which go（为空就说明PATH没生效）或brew --prefix go查Homebrew路径 - Zsh用户改
~/.zshrc，追加export PATH="/opt/homebrew/bin:$PATH"（Apple Silicon）或export PATH="/usr/local/bin:$PATH"（Intel） - Bash用户改
~/.bashrc，内容同上；Windows用户去「系统属性 → 高级 → 环境变量」，把C:\Go\bin或安装目录下的\bin加进Path - 改完必须重载：
source ~/.zshrc，再跑go version和which go双验
GOROOT设错会导致标准库加载失败
绝大多数情况根本不用设GOROOT——Go安装包自带的二进制会自动推导。手动设错（比如export GOROOT=$HOME/go）反而让go build报cannot find package "fmt"这类错误，因为标准库路径彻底错了。
实操建议：
- 运行
go env GOROOT，输出应和which go的上级目录一致（如/usr/local/go） - 如果输出异常，全局搜
~/.zshrc、~/.profile、/etc/profile，删掉所有export GOROOT=...行 - IDE（VS Code/GoLand）会缓存GOROOT，改完环境变量后必须重启IDE，否则插件仍用旧值
- 多版本共存时别硬编码GOROOT，用
gvm或asdf管理，而不是靠环境变量切换
GOBIN和GOPATH混用会污染工具链
把GOBIN指向$GOPATH/bin看似省事，实际CI里常因go install覆盖旧工具（比如golangci-lint）导致构建突然失败。更麻烦的是，多人共用NFS挂载的home目录时，$GOCACHE并发写入可能损坏。
实操建议：
-
GOBIN单独设为$HOME/go-bin，确保$HOME/go-bin在PATH中且排在$GOPATH/bin之前 -
GOPATH保持默认$HOME/go即可，不要设成项目路径（如~/myproj/go），否则go mod vendor行为不可控 -
GOCACHE显式设为$HOME/.cache/go-build，避免NFS锁争用；若服务器禁用home缓存，改用/tmp/$USER/go-cache - 绝对不用
go env -w写全局配置——它生成的$HOME/go/env是纯文本，无权限校验，sudo误操作会污染所有用户
模块路径写错会让go mod tidy直接报错
go mod init myproject看着能跑，但后续go mod tidy会卡在no required module provides package。问题出在模块名不是物理路径，而是导入路径根，写成本地文件夹名或含大写字母/下划线，Go工具链根本无法解析依赖。
实操建议：
- 模块名用虚拟路径，格式统一为
github.com/username/projectname，即使项目没托管也这么写 - 禁止用
go mod init ./myproj或go mod init My_Project，后者会触发malformed module path - CI脚本里加校验：
head -n1 go.mod | grep -q "^module github.com/"，不匹配就提前退出 - 私有域名场景下，确保
GOINSECURE或git协议配置允许解析该域名，否则go get会超时
go 1.xx版本，这两处不一致时，语法检查、跳转、甚至go test都可能静默失效，而错误提示往往藏在底层日志里，不是一眼能看见的。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
