Go语言环境搭建易在GOPATH、GOBIN、模块初始化时机和代理配置上出错：需验证go version并配置PATH；go mod init须在项目根目录执行；国内必须设置GOPROXY=https://goproxy.cn,direct；go.sum不可手动删除，应通过go mod tidy修复。
Go 语言环境搭建本身不难，但容易在 GOPATH、GOBIN、模块初始化时机和代理配置这几个点上卡住，导致 go run 报错、go get 失败或依赖拉不下来。
确认系统已安装 Go 并验证版本
别直接信包管理器或旧安装记录，先终端里敲：
go version
如果报 command not found，说明没进 $PATH；Mac 上用 Homebrew 装的通常在 /opt/homebrew/bin/go，Linux 可能是 /usr/local/go/bin/go。把对应 bin 目录加进 $PATH（比如 export PATH=$PATH:/usr/local/go/bin），再开新终端重试。
建议用官方二进制包而非系统包管理器装，避免版本滞后——尤其 macOS 上 brew install go 有时会延迟更新小版本。
立即学习“go语言免费学习笔记（深入）”；
初始化 Go 模块前必须 cd 到项目根目录
go mod init 不是全局命令，它只在当前目录生成 go.mod。很多人在桌面或家目录下随手执行，结果所有项目共用一个 go.mod，后续 go run 就会报 no required module provides package。
正确做法：
- 新建空目录，
cd进去 - 运行
go mod init example.com/myapp（模块名可以是假域名，但别用main或空字符串） - 立刻写个
main.go，内容至少含package main和func main()
此时再 go run . 才会触发模块解析，而不是退回到 GOPATH 模式。
国内用户必须配 GOPROXY，否则 go get 基本失败
默认代理 https://proxy.golang.org 在国内无法稳定访问，常见错误是：
go: github.com/some/pkg: Get "https://proxy.golang.org/...": dial tcp 142.251.42.238:443: i/o timeout- 或卡在
verifying github.com/...几分钟不动
执行这条命令永久生效：
go env -w GOPROXY=https://goproxy.cn,direct
注意：direct 是关键，它表示对私有仓库（如公司内网 Git）跳过代理；如果全用 https://goproxy.cn，私有模块就拉不到。
验证是否生效：go env GOPROXY 应输出 https://goproxy.cn,direct。
go.sum 文件被修改后不能手动删
有人遇到 go: downloading ... 卡住，就删掉 go.sum 试图“重来”。这会导致校验失败，下次 go build 会报 checksum mismatch。
真正该做的是：
- 保留
go.sum，运行go mod tidy自动修复缺失项 - 若提示某模块校验失败，先确认是否用了非官方镜像源（比如把
goproxy.cn换成不可信的第三方代理） - 极少数情况需强制刷新：先
go clean -modcache清缓存，再go mod download
模块校验机制是 Go 的安全底线，绕过它等于放弃依赖完整性保护。
