Go 1.16起默认启用GO111MODULE=on，不再依赖GOPATH；必须显式设为on以确保模块机制稳定运行，避免auto模式路径判断不可靠或off模式完全禁用模块功能。
Go 1.16 起默认启用 GO111MODULE=on，不再强制依赖 GOPATH；你现在可以直接在任意目录初始化项目，go mod init 就够了——旧式 GOPATH 工作流已过时，硬套反而容易出错。
go version 和 go env 验证失败的常见原因
执行 go version 报 command not found: go，或 go env 显示空值，基本就两类问题：
-
/usr/local/go/bin（Linux/macOS）或C:\Go\bin（Windows）没加进PATH—— 检查echo $PATH或echo %PATH%输出里有没有它 - 安装后开了新终端但没 reload 配置：Linux/macOS 执行
source ~/.zshrc（或~/.bashrc），Windows 则需重启命令行或 PowerShell - macOS 上用 Homebrew 安装却仍去官网下 .pkg：Homebrew 默认装到
/opt/homebrew/bin（Apple Silicon）或/usr/local/bin（Intel），不是/usr/local/go/bin
go run 与 go build 的关键区别和选法
go run 是调试用的快捷方式，go build 才是生产部署的起点。两者行为差异直接影响开发节奏：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
go run main.go编译并立即执行，不生成文件，适合快速验证逻辑 -
go build -o myapp main.go生成可执行二进制，名字、路径、目标平台全可控 - 跨平台编译必须用
go build：比如GOOS=linux GOARCH=arm64 go build -o myapp-linux-arm64 - 如果项目含多个
.go文件，go run .比罗列所有文件名更安全；go build .同理
go mod init 初始化失败时该看什么
go mod init 报 cannot determine module path 或反复生成 go.mod 却不识别依赖，通常卡在这几个点：
立即学习“go语言免费学习笔记（深入）”；
- 当前目录已有
go.mod但模块路径写错了（比如含非法字符、以.开头），删掉重试 - 想用公司私有域名做模块路径（如
git.example.com/team/project），但本地 Git remote URL 不匹配，先git remote set-url origin对齐 - 用了代理但
GOPROXY没设对：go env -w GOPROXY=https://goproxy.cn,direct（国内推荐） -
go mod tidy提示找不到包？检查go.sum是否被误删，或网络是否能连通 proxy
真正麻烦的不是装 Go，而是把 go 命令变成条件反射的一部分——比如改完代码顺手敲 go fmt ./... 再 go test ./...，这种节奏一旦建立，环境才算“活”了。
