Go环境配置核心是GOROOT必须指向真实安装路径、GO111MODULE必须为on；需确认系统架构（amd64/arm64）下载匹配安装包，验证go version输出架构一致；GOROOT一般无需手动设置，GOPATH现代开发中非必需；必须启用Go Modules并配置国内代理（如goproxy.cn）及GOSUMDB校验。
go 环境搭得不对，后续所有 go run、go build、go mod 都会出问题。不是版本装不上，就是模块拉不下来，或者 go install 的工具找不到——核心就两点：GOROOT 必须指向真实安装路径，GO111MODULE 必须为 on，其余都是细节。
确认系统架构再下载安装包
很多编译失败或命令报错，源头其实是装错了架构版本。别直接点“Download”就下，先看清楚自己机器是 amd64 还是 arm64（M1/M2/M3 Mac、树莓派、AWS Graviton 实例都属于后者）。
- Linux/macOS 执行
uname -m：输出x86_64→ 选linux-amd64.tar.gz或darwin-amd64.pkg；输出aarch64或arm64→ 必须选带arm64后缀的包 - Windows 用户注意：新版 PowerShell 默认是 64 位，但某些旧版 CMD 可能仍跑在 32 位兼容层，建议统一用 PowerShell 验证
- 装完立刻验证：
go version输出里必须包含你的实际架构，比如linux/amd64或darwin/arm64，否则二进制不匹配，后续任何编译都会静默失败或 panic
GOROOT 和 GOPATH 不要混着设
GOROOT 是 Go 安装位置，GOPATH 是你放代码的老式工作区——但现代开发中，GOPATH 已非必需，硬设反而容易冲突。
-
GOROOT一般不用手动设：Linux/macOS 解压到/usr/local/go、Windows 装在C:\Program Files\Go，安装程序或 tar 命令会自动识别；如果手动改过路径，必须确保$GOROOT/bin在PATH里，且go env GOROOT输出和物理路径一致 -
GOPATH建议只在需要go install第三方工具（如gopls、dlv）时才显式设置；若不设，默认是$HOME/go，但它的src子目录已不再用于存放你自己的项目（那是 Go Modules 的事） - 常见坑：
export GOPATH=$PWD这种写法会导致go mod init失败，因为 Go 会拒绝在GOPATH内部初始化 module；正确做法是离开任意GOPATH目录后再建项目
Go Modules 必须启用且代理要配对
Go 1.16+ 默认开启模块模式，但国内不配代理，go mod download 会卡死或超时，连 go list -m all 都跑不动。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 执行
go env -w GO111MODULE=on强制启用（即使你用的是 1.20+，也建议显式写一次，避免被 shell 环境变量覆盖） - 代理推荐两个组合：
https://goproxy.cn,direct（稳定、中文文档全）或https://proxy.golang.org,direct（官方，但国内不稳定）；阿里云镜像https://mirrors.aliyun.com/golang/只提供安装包，不支持模块代理 - 校验和数据库也要同步设：
go env -w GOSUMDB=sum.golang.org；如果公司内网禁外网，可设为off，但必须清楚后果：跳过 checksum 校验，存在依赖投毒风险 - 验证是否生效：
go env GOPROXY GOSUMDB GO111MODULE三者输出应全部符合预期，缺一不可
标准编译流程：从 go mod init 到 go build
一个干净的 Go 项目，不依赖 GOPATH，只靠 go.mod 文件驱动整个生命周期。
立即学习“go语言免费学习笔记（深入）”；
- 新建空目录，执行
go mod init example.com/myapp（模块名不必真实可访问，但需符合域名格式，避免纯数字或下划线） - 写好
main.go后，直接go run .运行；它会自动解析go.mod、下载缺失依赖、编译并执行——无需go get预装 - 生成可执行文件：
go build -o myapp .；注意末尾的.表示当前目录，漏掉会报no Go files in - 交叉编译（比如在 macOS 上编译 Linux 二进制）：
GOOS=linux GOARCH=amd64 go build -o myapp-linux .；GOOS和GOARCH必须拼写准确，大小写敏感，GOARCH=arm64不能写成ARM64
go mod 操作（包括 go run 隐式触发的）都会读取 go.sum 并校验哈希，一旦你手动编辑过 go.mod 或删过 go.sum，下次 go build 就可能因校验失败而中断——这不是网络问题，是完整性保护机制在起作用。 
