go命令找不到需检查PATH是否包含$GOROOT/bin；依赖失败须配置GOPROXY和GO111MODULE；多版本推荐用goenv管理；go build报错常因GOBIN权限或路径问题。
go 命令找不到？检查 PATH 是否包含 $GOROOT/bin
这是最常遇到的问题：装完 Go，终端却报 command not found: go。根本原因不是没装好，而是 shell 找不到 go 这个二进制文件。
手动安装（比如解压到 /usr/local/go）后，go 实际在 /usr/local/go/bin/go。你必须把这一路径加进 PATH，否则系统永远“看不见”它。
- 确认
GOROOT值：运行echo $GOROOT，若为空，先设为安装路径，例如export GOROOT=/usr/local/go - 追加
PATH：执行export PATH=$PATH:$GOROOT/bin（临时生效）；长期生效需写入~/.zshrc或~/.bash_profile - 验证：执行
which go，输出应为/usr/local/go/bin/go；再跑go version确认版本
注意：macOS Catalina 及以后默认用 zsh，别往 ~/.bash_profile 里写——改了也白改。
依赖下载失败或超时？必须配置 GOPROXY 和 GO111MODULE
国内用户不配代理，go mod download 几乎必卡在 golang.org/x/... 上。这不是网络问题，是 Go 默认不走镜像源。
立即学习“go语言免费学习笔记（深入）”；
GO111MODULE=on 是启用模块模式的开关，而 GOPROXY 决定从哪拉包。两者缺一不可。
- 设置国内代理：执行
go env -w GOPROXY=https://goproxy.cn,direct（direct表示私有模块直连） - 强制启用模块：执行
go env -w GO111MODULE=on（Go 1.16+ 默认开启，但旧环境或 Docker 容器中仍可能关闭） - 验证：运行
go env | grep -E "(GOPROXY|GO111MODULE)"，两行都应有明确输出
如果项目已有 go.mod 却提示“cannot find module”，大概率是 GO111MODULE 被设为 auto 或 off，导致 Go 忽略模块文件。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
多个 Go 版本共存？别硬改 GOROOT，用 goenv 管理
手动切换 GOROOT 并重载 shell 配置，看着简单，实际极易出错：路径写错、忘记 source、不同终端行为不一致……尤其当你同时维护 Go 1.19（老项目）和 Go 1.22（新项目）时。
goenv 是专为多版本设计的工具，行为类似 nvm，所有操作只影响当前 shell 会话或项目目录。
- 安装：
git clone https://github.com/goenv/goenv.git ~/.goenv，然后将~/.goenv/bin加入PATH - 安装指定版本：
goenv install 1.22.3（自动下载编译，无需手动解压） - 切换版本：
goenv local 1.22.3（仅当前目录生效），或goenv global 1.21.6（全局默认）
关键点：goenv 不动系统级 GOROOT，它通过 wrapper 脚本动态注入正确路径——这意味着你不用反复修改环境变量，也不会污染其他项目。
go run 成功但 go build 报错？检查 GOBIN 和权限
go run main.go 能跑，不代表构建可执行文件就没问题。常见现象是 go build -o myapp 提示 permission denied 或静默失败。
根源往往在 GOBIN 设置不当或目标目录无写权限。
-
GOBIN默认为空，此时go build输出到当前目录；若你显式设了GOBIN=/usr/local/bin，就得确保该路径可写（通常需要sudo） - 更安全的做法是设
GOBIN=$HOME/go/bin，并确保$HOME/go/bin存在且用户有写权限（mkdir -p $HOME/go/bin） - 顺手加一句：
export PATH=$PATH:$GOBIN，这样构建出的二进制能直接命令行调用
容易被忽略的是：某些 IDE（如 VSCode）启动终端时不会加载用户 shell 配置，导致 GOBIN 未生效——这时要检查 IDE 的终端设置或改用外部终端验证。
