Go 1.21+ 默认启用模块模式，GO111MODULE=on 是安全起点；GOPATH 不再强制要求但保留可兼容旧工具，需确认架构、清理旧环境、正确设置 GOROOT 和 PATH，配置 GOPROXY=https://goproxy.cn,direct，并推荐预装 gopls、dlv 等开发工具。
Go 1.21+ 已默认启用模块模式，GO111MODULE=on 是安全起点；GOPATH 不再强制要求，但保留它仍能避免部分老项目或工具（如 go get 旧用法）报错。
确认系统架构与清理旧环境
很多编译失败其实源于架构错配或残留配置。别跳过这步：
- 运行
uname -m（Linux/macOS）或echo %PROCESSOR_ARCHITECTURE%（Windows），确认是x86_64还是arm64，下载对应 Go 安装包 - 检查是否残留旧版 Go：执行
which go或where go，若指向/usr/local/go以外路径（如/home/user/go/bin/go），说明可能有多个版本冲突 - 删除旧
GOPATH下的pkg和bin目录（保留src仅当真有历史项目依赖）
安装 Go 并验证 GOROOT 与 PATH
GOROOT 必须准确指向解压/安装目录，否则 go build 可能找不到标准库。
- Linux/macOS：解压后将
go/bin加入PATH，同时显式设置GOROOT（哪怕它和默认路径一致）：export GOROOT=/usr/local/goexport PATH=$GOROOT/bin:$PATH - Windows：在系统环境变量中新增
GOROOT（如C:\Go），并把%GOROOT%\bin放到PATH开头 - 验证命令必须用
go version和go env GOROOT两行，只看前者容易误判
初始化模块并绕过国内网络限制
国内拉取 golang.org/x/... 包失败是高频问题，靠改 GO_PROXY 就够，不用动 git 配置或手动替换 import 路径。
立即学习“go语言免费学习笔记（深入）”；
- 执行：
go env -w GOPROXY=https://goproxy.cn,direct
注意末尾的direct—— 它保证私有仓库（如公司内网 Git）不走代理 - 新建项目时直接
go mod init myapp，不要进$GOPATH/src再 init，后者会触发GO111MODULE=auto的模糊行为 - 如果已有项目
go.mod里出现replace指向本地路径，删掉它；现代 Go 不需要手动 replace 标准库子包
可选但推荐：预热 go install 常用工具
像 gopls、dlv 这类工具不随 Go 安装，且 VS Code Go 插件默认从 $GOBIN 查找它们。提前装好能避免调试时弹出“command not found”。
- 先确保
GOBIN已设（例如export GOBIN=$HOME/go/bin），并加入PATH - 运行：
go install golang.org/x/tools/gopls@latestgo install github.com/go-delve/dlv/cmd/dlv@latest - 验证：
which gopls应输出$GOBIN/gopls，不是$GOROOT/bin/gopls
真正容易被忽略的是 GOBIN 和 PATH 的顺序——如果 $GOROOT/bin 在 $GOBIN 后面，你 go install 的二进制文件永远无法被调用到。
