Windows用户安装go1.25.0.windows-amd64.msi后，必须重启终端才能使PATH生效，否则go version报错；默认路径C:\Program Files\Go不可含空格或中文，GOROOT无需手动设置。
Windows上用.msi安装包最省事，但环境变量要重开终端才生效
Windows用户直接下载 go1.25.0.windows-amd64.msi 双击安装，它会自动把 C:\Program Files\Go\bin 加进系统 PATH，不用手动配 GOROOT。但很多人卡在验证环节——装完立刻开 CMD 运行 go version 报“不是内部或外部命令”，就是因为旧终端没读到新环境变量。
必须关闭所有已打开的 CMD / PowerShell / VS Code 终端窗口，再新开一个。否则 go 命令根本找不到。
- 默认安装路径是
C:\Program Files\Go，不建议改到带空格或中文的路径（比如D:\我的Go），某些老工具链会解析失败 - 如果非要自定义路径（如
D:\software\Go），安装后得手动加D:\software\Go\bin到系统PATH，且仍需重启终端 -
go env GOROOT应输出完整路径；若为空，说明GOROOT没被识别，大概率是终端没刷新
Linux/macOS手动解压安装时，/usr/local/go 是唯一推荐路径
用 wget https://go.dev/dl/go1.25.0.linux-amd64.tar.gz 下载后，必须解压到 /usr/local/go ——这是硬性约定。Go 工具链（比如 go build、go test）内部写死了从这个路径找标准库和 pkg 目录，换别的位置（如 $HOME/go 或 /opt/go）会导致编译报错或 go env 输出异常。
执行 sudo tar -C /usr/local -xzf go1.25.0.linux-amd64.tar.gz 后，只加一行到 ~/.bashrc 或 ~/.zshrc 就够了：
立即学习“go语言免费学习笔记（深入）”；
export PATH=$PATH:/usr/local/go/bin
别碰 GOROOT：新版 Go（1.16+）已默认识别 /usr/local/go，显式设 GOROOT 反而容易覆盖出错。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 不要用
sudo tar -xzf解压到非/usr/local路径再软链接过去——go不认符号链接下的GOROOT - Ubuntu/Debian 的
apt install golang安装的是系统仓库版（常为 1.18 或 1.19），go version显示的版本可能低于项目要求，优先选手动安装 - macOS 上用 Homebrew 装的 Go（
brew install go）路径在/opt/homebrew/opt/go/libexec，虽可用但和社区惯例不符，CI/CD 流水线容易出兼容问题
go mod init 和 go run 失败？八成是 GOPATH 或代理没设对
go run main.go 报 cannot find module providing package，或者 go mod init 后 go get 卡住不动，基本就是两个配置没到位：GOPROXY 和模块初始化位置。
先确认当前目录是不是空文件夹，且不在 $GOPATH/src 下（新版 Go 已不强制要求项目放这里）。然后一次性跑这三条命令（永久生效）：
go env -w GO111MODULE=on<br>go env -w GOPROXY=https://goproxy.cn,direct<br>go env -w GOSUMDB=sum.golang.org
GOPROXY 必须设成国内镜像，否则 go get 会超时；direct 是 fallback，保证私有包能回源拉取。
-
GO111MODULE=on是开关，不是可选项——哪怕你只写单文件，没go.mod，go run也会按模块模式查找依赖 -
GOPATH现在只影响go install输出二进制的位置（即$GOPATH/bin），不设也行，但建议明确设为$HOME/go避免工具链混乱 - 如果公司内网禁外网，
GOPROXY要换成内部 Nexus 代理地址，且GOSUMDB=off（不校验 checksum）
验证编译工具链是否完整，只用三行命令
别只信 go version。真正检验工具链有没有问题，就跑这三句：
go version<br>go env GOROOT GOSUMDB GOPROXY<br>go run -gcflags="-S" main.go 2>&1 | head -n 10
最后一句是关键：-gcflags="-S" 让编译器输出汇编，能直接验证 go tool compile 是否可用、是否支持目标平台。如果报 compile: no such file 或卡死，说明 GOROOT 下的 pkg 目录损坏或权限不对。
-
go env GOROOT输出空？检查/usr/local/go（Linux/macOS）或C:\Program Files\Go（Windows）是否存在且可读 -
go env GOPROXY显示https://proxy.golang.org？立刻重设，这是国内无法访问的地址 -
go run成功但go build -o app .报cannot load runtime: cannot find module？说明GOROOT/src/runtime缺失，重装安装包
最易忽略的点：Windows 用户装完 .msi 后没关旧终端，Linux/macOS 用户解压后忘了 source ~/.bashrc，这两步漏掉，后面所有验证都是徒劳。
