Go通过os.Getenv读取环境变量并设默认值（如"development"），封装为Env()函数统一处理；测试用TestMain显式设置/清理环境变量，依赖抽象为接口注入mock；禁用init中初始化全局客户端，CI中单行透传变量。
Go 本身没有内置的“环境变量模式”（如 Rails 的 RAILS_ENV 或 Node.js 的 NODE_ENV），但通过标准库 + 约定方式完全可以实现开发与测试环境的清晰隔离——关键不在“怎么设”，而在“在哪读、何时覆盖、谁来控制”。
用 os.Getenv 读取环境变量，但必须有默认兜底
Go 不会自动加载 .env 文件，所有环境配置都得显式读取。直接调用 os.Getenv("APP_ENV") 是常见起点，但危险在于：如果变量未设置，返回空字符串，容易导致逻辑分支错乱。
实操建议：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 始终用
os.Getenv("APP_ENV")读取，但立即判断是否为空，否则 fallback 到预设值（如"development"） - 避免在多个包里重复写判断逻辑，封装成一个全局函数，比如
Env()，统一处理默认值和大小写归一化（"dev"/"DEV"→"development"） - 测试时不要依赖真实环境变量，而应在测试前用
os.Setenv+defer os.Unsetenv显式模拟，防止污染其他测试用例
测试环境必须禁用真实外部依赖，用 build tag 或接口注入隔离
很多团队误以为只要 APP_ENV=test 就算隔离了，结果测试仍连真实数据库或发真实 HTTP 请求。Go 的测试隔离不是靠环境变量“声明”，而是靠代码结构“切断”。
立即学习“go语言免费学习笔记（深入）”；
实操建议：
- 把数据库连接、HTTP 客户端等外部依赖抽象为接口（如
DBClient、HTTPDoer），主程序通过构造函数注入，测试时传入 mock 实现 - 对无法重构的旧代码，可用
//go:build test构建标签 + 单独的config_test.go文件，在测试构建时强制覆盖配置（注意：需启用 Go modules 的-tags test） - 禁止在
init()函数中读取环境变量并初始化全局客户端——这会让测试无法重置状态
go test 默认不加载 shell 环境变量，必须显式传递
你在终端里执行 APP_ENV=test go test，实际对 go test 子进程无效，因为 Go 测试运行器不会继承父 shell 的环境变量（尤其在 CI 中更明显）。
实操建议：
- 用
go test -ldflags="-X main.env=test"配合var env = "development"全局变量，编译期注入（适合简单场景） - 更可靠的方式是：在
TestMain中统一设置，例如：
func TestMain(m *testing.M) {
os.Setenv("APP_ENV", "test")
os.Setenv("DB_URL", "sqlite://file::memory:?cache=shared")
code := m.Run()
os.Unsetenv("APP_ENV")
os.Unsetenv("DB_URL")
os.Exit(code)
}
这样所有子测试都能看到一致的测试环境，且退出前清理干净。
开发环境调试时别信 IDE 自动注入的环境变量
VS Code 的 launch.json 或 GoLand 的 Run Configuration 常被设为自动注入 APP_ENV=development，但这类配置只影响调试进程，不影响你手动执行的 go run main.go 或 go build 后的二进制运行——同一份代码可能在不同启动方式下走不同路径。
实操建议：
- 开发阶段统一用 Makefile 或
scripts/dev.sh启动，例如：APP_ENV=development DATABASE_URL=postgres://... go run main.go - 在程序启动时加一行日志：
log.Printf("running in %s mode", config.Env)，每次启动都确认输出，避免“以为是开发环境，其实是空字符串 fallback” - CI/CD 脚本中禁止写
export APP_ENV=test后跟go test——改用APP_ENV=test go test单行执行，确保变量透传
真正难的不是设环境变量，而是让每个依赖组件（DB、Cache、Logger、HTTP Client）都对当前环境有明确感知，并拒绝在错误环境下启动。一旦某个模块悄悄绕过环境检查直连生产 Redis，隔离就形同虚设。
