go环境可用性需验证PATH、GOROOT、GOPATH、GOBIN及GOPROXY配置是否正确生效，而非仅go version成功；须新开终端、用which/where确认二进制路径，检查go env输出，并设代理防mod下载失败。

go version 能跑通，不代表环境真正可用；很多问题要等 go run 或 go mod download 时才暴露。关键不是“装上”，而是“配对”。

验证 go 命令是否真在 PATH 里

很多人执行 go version 成功就以为万事大吉，但实际是终端缓存了旧路径，或当前 shell 没加载新配置。

• 关掉当前终端，新开一个，再跑 go version —— 这步不能跳
• 用 which go（Linux/macOS）或 where go（Windows）确认二进制位置是否和你预期的 GOROOT 一致
• 如果输出是 /usr/bin/go，说明系统自带或包管理器装的旧版（比如 Ubuntu 的 apt install golang），它通常缺 src 和 pkg，后续 go build -buildmode=shared 会直接失败
• 运行 go env GOROOT，看是否指向你手动解压的目录（如 /usr/local/go 或 $HOME/local/go），而不是空或系统路径

GOPATH 和 GOBIN 必须显式设，尤其多用户/CI 场景

Go 1.16+ 默认 fallback 到 $HOME/go，但这在 NFS 共享家目录、定时任务或 CI runner 中极易引发并发写冲突或权限错误。

• 在 ~/.bashrc 或 ~/.zshrc 里明确写：

  export GOPATH=$HOME/go
  export GOBIN=$HOME/bin
  export PATH=$GOBIN:$PATH

• $HOME/bin 通常已在 PATH 中（macOS/Linux 默认），不重复加；Windows 可设为 %USERPROFILE%\bin
• 避免用 go env -w GOPATH=... —— 它写入 $HOME/go/env，无权限控制，且优先级高于 shell export，调试时容易误判
• 检查 go env GOPATH 和 go env GOBIN 输出是否与 shell 中一致，不一致说明有隐式覆盖

模块代理和网络连通性常被忽略

go mod download 卡住、超时或报 cannot load module，90% 不是代码问题，而是代理或 DNS。

Golang Google Wire

在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface

下载

• 国内用户必须设 GOPROXY：

  export GOPROXY=https://goproxy.cn,direct

  （direct 表示私有模块走直连）
• 别只设一次：把它加进 shell 配置文件，并 source 生效；否则 go run 启动时可能仍用默认 https://proxy.golang.org
• 验证代理是否生效：运行 go env GOPROXY，确认输出含 goproxy.cn 或你指定的地址
• 若公司内网禁外网，需搭私有 proxy（如 Athens），此时 GOPROXY 应指向内网地址，且确保 GOINSECURE 包含对应域名（如 export GOINSECURE=my-proxy.internal）

多版本共存时，GOROOT 不能靠 go env -w 切换

go env -w GOROOT=... 是危险操作：它把值写死进 $HOME/go/env，一旦设错，所有子 shell 都继承，且 go version 显示的仍是当前二进制版本，极易误导。

立即学习“go语言免费学习笔记（深入）”；

• 正确做法是每个版本独立解压到不同路径（如 $HOME/local/go1.21、$HOME/local/go1.22），然后用 shell alias 或函数切换：

  alias go121='export GOROOT=$HOME/local/go1.21; export PATH=$GOROOT/bin:$PATH'
  alias go122='export GOROOT=$HOME/local/go1.22; export PATH=$GOROOT/bin:$PATH'

• 或者用 goenv（macOS/Linux）： goenv install 1.22.5 → goenv global 1.22.5，它通过 wrapper 动态替换 GOROOT
• 切记：每次切换后，立刻运行 go version 和 go env GOROOT 双重确认，因为 PATH 顺序错了也会加载错 binary

真正卡住人的从来不是下载和解压，而是环境变量的可见范围、模块代理的实际生效路径、以及多版本下 GOROOT 的动态绑定方式——这些细节不验清楚，写一百行代码都可能败在一开头的 go mod tidy 上。