Go 1.18安装需配置GOPATH以兼容老项目，推荐设为自定义路径如/Users/xxx/Code/Go；GOROOT通常无需手动设置；老项目若用go vendor，须确保目录结构符合$GOPATH/src导入路径约定。
Go 环境搭建本身不难，但新手常卡在三个地方：代理不通、GOPROXY 配错、go mod 和 GOPATH 混用导致依赖拉不下来或找不到包。2026 年当前最稳的路径是直接用 Go 1.21+ + go mod + 国内代理，跳过 GOPATH 旧模式。
go version 太低或报 command not found
说明 PATH 没生效，或安装时没勾选“Add to PATH”（Windows 安装器）；Linux/macOS 解压后没把 /usr/local/go/bin 加进 PATH。
- Windows：检查系统环境变量里是否有
%GOROOT%\bin，且GOROOT指向正确目录（如C:\Go） - Linux/macOS：确认
~/.bashrc或~/.zshrc里写了export PATH=$PATH:/usr/local/go/bin，然后运行source ~/.zshrc - 别信“自动配置”，高版本安装器在某些 Windows 版本上会漏掉 PATH，手动补最保险
go get 失败 / proxy.golang.org timeout
这是国内最常见问题，go get 默认走 https://proxy.golang.org，直连基本超时。
- 执行
go env -w GOPROXY=https://goproxy.cn,direct（推荐）或https://goproxy.io,direct - 如果公司内网有私有代理，可设为
http://your-proxy:8080，但末尾必须加,direct，否则私有模块无法 fallback - 验证：运行
go env GOPROXY，输出应为设置的地址，不是空或off
go mod init 后 go run 报 no required module provides package
典型症状：项目根目录有 go.mod，但 go run main.go 提示找不到 fmt 或其他标准库——其实是模块名写错了，或当前不在模块根目录下运行。
立即学习“go语言免费学习笔记（深入）”；
- 确保
go mod init时传的是合法模块路径，比如go mod init example.com/hello，不要用.或空字符串 - 运行命令前，
cd到go.mod所在目录，go命令靠这个文件定位模块根 - 如果只是想快速跑个 demo，不用
go mod也行：go run main.go会自动临时构建，但加了第三方依赖就必须用go mod
GOROOT 和 GOPATH 还需要配吗
GOROOT 一般不用手动设——只要 go 命令能执行，它就知道自己在哪；GO111MODULE=on 开启后，GOPATH 对依赖管理已无作用，只影响 go install 编译出的二进制存放位置（默认是 $GOPATH/bin）。
- 如果你用
go install xxx@latest装工具（比如gofumpt），记得把$GOPATH/bin加进PATH，否则命令找不到 - 不想管
GOPATH？直接用go install -o $HOME/bin/xxx指定输出路径，然后把$HOME/bin加进PATH - 别为了“规范”硬配
GOROOT，除非你解压到非标准路径且go version报错
真正容易被忽略的是：go mod 初始化后，go.sum 文件必须提交进 Git，否则别人 clone 下来 go build 可能校验失败；还有，CI/CD 流水线里要显式指定 GO111MODULE=on，别依赖本地环境变量。
