Go开发环境搭稳需满足三要素：go命令可用、go mod能锁依赖、GOOS/GOARCH可交叉编译；若go version报command not found，实为PATH未生效，须手动确认Go二进制路径（如/usr/local/go/bin或C:\Go\bin）已加入系统PATH并重启终端验证。
go 命令能跑起来，go mod 能锁依赖，GOOS/GOARCH 能交叉编译出目标平台可执行文件——这三件事做对了，Golang 开发环境就算搭稳了。其余都是锦上添花。
go version 报 command not found 怎么办
不是没装好，是 PATH 没生效。别信安装器勾选的“添加到 PATH”，它常失效。
- macOS/Linux：运行
which go，没输出就检查/usr/local/go/bin（或你解压的路径）是否加进~/.zshrc或~/.bash_profile；改完记得source ~/.zshrc - Windows：用 PowerShell 运行
Get-Command go；失败就去「系统属性 → 高级 → 环境变量」里确认C:\Go\bin（或你安装路径）进了PATH - 验证：新开终端，直接输
go version，有输出才算真通
go mod init 失败或生成错误 module 名
旧项目残留干扰最常见，go mod init 不是万能钥匙，它会看上下文猜你想干啥。
- 删掉项目根目录下的
vendor/目录（除非你明确要用 vendor） - 确保当前目录不在
$GOPATH/src下——如果在，go mod init会强行按旧路径推导 module 名，比如变成src/myapp，这不是你想要的 - 运行
go env -w GO111MODULE=on强制启用模块模式（Go 1.16+ 默认开启，但 CI 或老脚本可能关着） - module 名写成
hello、mytool都行，不强制要域名；后续发布时再改成github.com/user/repo
在 macOS 上构建 Windows 可执行文件失败
不是 GOOS=windows 就万事大吉，cgo 和 CGO_ENABLED 是隐形开关。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 默认
CGO_ENABLED=1，一旦代码里用了import "C"（比如调 SQLite、OpenSSL），构建就会卡住，报错类似：exec: "gcc": executable file not found in $PATH - 纯 Go 项目（没 cgo）：直接
GOOS=windows GOARCH=amd64 go build -o myapp.exe main.go即可 - 含 cgo 的项目：要么装 MinGW-w64（macOS 上麻烦），要么用 Docker 构建——推荐
docker run --rm -v $(pwd):/app -w /app golang:1.22 bash -c 'CGO_ENABLED=1 GOOS=windows GOARCH=amd64 go build -o myapp.exe main.go' - 想彻底规避 cgo？加
CGO_ENABLED=0，但注意：部分标准库（如netDNS 解析）行为会降级，且无法链接 C 库
多人共用服务器时 GOPATH 冲突
go install 写入 $GOPATH/bin，go mod download 写入 $GOCACHE，NFS 挂载家目录下并发写容易损坏缓存。
- 每个用户在家目录独立解压 Go：比如
~/local/go，然后export GOROOT=$HOME/local/go、export PATH=$GOROOT/bin:$PATH - 显式设
GOPATH=$HOME/go、GOBIN=$HOME/bin、GOCACHE=$HOME/.cache/go-build（避免 NFS 锁争用） - 禁用
go env -w：它写入的$HOME/go/env是纯文本，无权限校验，误用sudo go env -w会污染所有用户环境
跨平台构建真正难的不是命令怎么敲，而是判断哪段代码依赖了 cgo、哪台机器的 GOCACHE 已被并发写坏、哪个同事悄悄改了 GO111MODULE 环境变量——这些点不查日志、不看 go env 输出，光靠重装 Go 解决不了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
