Go语言环境隔离分三层：依赖隔离靠go.mod、SDK版本隔离靠shim路径顺序、运行时配置隔离需显式初始化GO_ENV并校验，混用会导致版本冲突或配置错误。
Go 语言本身没有“虚拟环境”概念，所谓“环境隔离”实际是三个层面的分别处理：依赖版本隔离、Go SDK 版本隔离、运行时配置隔离。搞混这三者，就会反复踩坑——比如用 asdf 切了 Go 版本，但 go build 仍报模块解析错误；或者 go.mod 锁死了依赖，却在生产环境连错数据库。
依赖隔离靠 go.mod，不是靠目录或 shell 环境
每个项目根目录下的 go.mod 文件就是它的依赖边界。Go 工具链会自动根据当前路径读取它，不关心你是否在 $GOPATH 里、也不看你 PATH 里有什么。
-
go mod init your-project后，所有go get/go build都只认这个文件里的require和replace - 不同项目可同时使用
github.com/sirupsen/logrus v1.9.0和v2.3.0，互不干扰 - 别把项目塞进
$GOPATH/src——Go 1.13+ 默认忽略它；混放会导致go list -m all输出混乱 - 想彻底禁用 GOPATH 模式？设环境变量
GO111MODULE=on，且确保没在项目外执行go mod命令
Go SDK 版本隔离靠 shims，PATH 顺序决定一切
ASDF、GVM、goenv 这类工具本质是生成一堆 shell 代理脚本（shim），真正起作用的是你 PATH 里谁排前面。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 运行
which go，输出必须是~/.asdf/shims/go（ASDF）或~/.gvm/bin/go（GVM），而不是/usr/local/bin/go - 检查
echo $PATH开头是否含 shim 路径；若没有，在~/.zshrc末尾加export PATH="$HOME/.asdf/shims:$PATH"，然后source ~/.zshrc - ASDF 用户装完新版本后，必须跑
asdf reshim golang，否则 shim 不更新 -
.tool-versions必须和go.mod在同一级目录，且内容只能是golang 1.22.6（无空格、无注释、无 BOM）
运行时配置隔离靠 GO_ENV + 显式初始化，别信 viper.AutomaticEnv()
环境变量读取必须集中、归一化、带校验。裸调 os.Getenv("GO_ENV") 是最大隐患——它返回空字符串而非 nil，且大小写不敏感。
立即学习“go语言免费学习笔记（深入）”；
- 封装一个
Env()函数：env := strings.ToLower(os.Getenv("GO_ENV")); if env == "" { env = "development" } - 敏感字段（如
API_KEY）绝不设默认值，为空就log.Fatal("missing API_KEY") - 禁用
viper.AutomaticEnv()——它会把HOME、PWD全当配置注入，直接破坏结构体字段映射 - 测试时用
TestMain显式设os.Setenv("GO_ENV", "test")，避免依赖 shell 环境透传（CI 中根本不可靠）
最容易被忽略的点：go.work 只影响本地开发时的多模块编辑体验，构建发布时仍以各子模块自己的 go.mod 为准；而 GO_ENV 的值如果没在 NewConfig() 初始化阶段就确定，后续任何包里调 os.Getenv 都可能拿到旧值或空值——尤其当 init() 函数里有隐式依赖时。
