Go环境配稳的关键是GO111MODULE、GOPROXY、GOROOT三变量对齐且无旧配置干扰；Windows需重启终端，Linux/macOS需重载shell配置；go version成功但go get失败多因模块未启用或代理未生效；GOPROXY应设为https://goproxy.cn,direct并用go env验证；go build须用-o指定输出；Go 1.16+可忽略GOPATH；go install易引发路径冲突，推荐go build替代；配完务必重启终端并用go env确认三变量。
Go 环境能不能一次配稳，关键不在装没装上，而在 GO111MODULE、GOPROXY、GOROOT 三个变量是否对齐，且不被旧配置残留干扰。Windows 上用 .msi 安装后不重启终端，Linux/macOS 手动解压后不重载 ~/.bashrc 或 ~/.zshrc，90% 的“能 go version 但拉不了包”问题都出在这。
go version 能跑但 go get 失败：代理和模块开关没生效
这是国内用户最常卡住的点——命令行显示 go version go1.25.0 linux/amd64，但一执行 go get github.com/gin-gonic/gin 就超时或报 proxy.golang.org: no such host。
-
GO111MODULE=on必须开启，否则go get不走代理，直接连官方源 -
GOPROXY推荐设为https://goproxy.cn,direct（七牛云），比https://goproxy.io更稳定；direct表示代理查不到时回落官方，不是“绕过代理” - 验证方式不是看
echo $GOPROXY，而是运行go env GOPROXY——因为go env读的是 Go 内部生效值，$GOPROXY只是 shell 变量缓存，可能没刷新 - Windows PowerShell 用户注意：
$env:GOPROXY="https://goproxy.cn,direct"是临时生效，永久必须用[Environment]::SetEnvironmentVariable("GOPROXY", "...", "Machine")
go build 输出文件名和路径控制：-o 参数必须显式指定
go build 默认在当前目录生成同名可执行文件（如 main.go → main），但 Windows 下是 main.exe，Linux/macOS 没后缀。不加 -o 很容易误以为没生成，或覆盖已有二进制。
- 想输出到指定目录并改名，必须写全路径：
go build -o ./dist/myapp ./cmd/main.go - 如果
main包分散在多个文件（如main.go+handler.go），不能只写go build main.go，要写go build -o ./myapp ./...或进入项目根目录执行go build -o ./myapp . - 交叉编译时，
GOOS和GOARCH需提前设好，例如编译 Linux 版：GOOS=linux GOARCH=amd64 go build -o ./dist/app-linux .；Windows 下用 PowerShell 要写成$env:GOOS="linux"; $env:GOARCH="amd64"; go build -o ./dist/app-linux .
GOPATH 还要不要配：Go 1.16+ 基本可以忽略
除非你维护老项目或用某些依赖 GOPATH 的工具（如旧版 gocode），否则现在完全不用手动设 GOPATH。Go Modules 开启后，依赖自动下载到 $GOPATH/pkg/mod，但项目代码可放在任意路径，go mod init myproject 后就与 GOPATH/src 无关了。
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
立即学习“go语言免费学习笔记（深入）”；
- 检查是否真不需要：运行
go env GOPATH，如果输出是$HOME/go（macOS/Linux）或C:\Users\XXX\go（Windows），说明 Go 自动设了默认值，你不改它就行 - 如果项目里有
go.mod文件，go run .或go build .会自动识别模块根，不再扫描GOPATH/src - 唯一要小心的是：VSCode 的 Go 插件有时会因缓存误读旧
GOPATH，此时删掉~/.vscode/extensions/golang.go-*/out/并重启编辑器
go install 编译到 $GOPATH/bin 的陷阱
go install 看似方便，但它要求模块路径必须是完整 URL 形式（如 example.com/cmd/mytool），且会把二进制硬塞进 $GOPATH/bin ——这在多 Go 版本共存或 CI 环境里极易冲突。
- 替代方案更可控：
go build -o $(go env GOPATH)/bin/mytool .，自己掌握输出位置 - 如果坚持用
go install，确保go.mod里module声明合法，且当前目录是模块根（即含go.mod） - CI/CD 流水线中禁用
go install，改用go build -o ./bin/xxx+ 显式PATH=./bin:$PATH，避免污染构建机环境
真正麻烦的从来不是“怎么装”，而是不同系统下环境变量加载时机、shell 类型（bash/zsh/PowerShell）、以及 Go 工具链自身对 go env 和 shell 变量的读取优先级差异。每次配完，务必关掉所有终端重开，再跑一遍 go env | grep -E "(GO111MODULE|GOPROXY|GOROOT)" 确认三者全在线。
