go多环境配置核心是用go_env变量驱动加载config.dev.yaml等约定文件，early读取、显式校验、结构体分环境定义、禁止fallback，确保隔离与安全。
Go 本身不内置环境配置管理，但通过组合 os.Getenv、flag、结构体绑定和外部文件解析，能干净地支撑多环境。关键不在“用什么库”，而在“如何隔离变量作用域 + 避免硬编码 + 保证加载顺序”。
用 GO_ENV 控制配置加载路径
别依赖 go build -ldflags 注入环境名，它难调试且无法动态切换。统一用环境变量 GO_ENV（值为 dev、test、prod）驱动配置初始化逻辑：
-
GO_ENV必须在main()最早处读取，且只读一次；后续任何包都不应再调用os.Getenv("GO_ENV") - 配置文件按约定命名：
config.dev.yaml、config.test.yaml、config.prod.yaml，放在./configs/下 - 加载失败时 panic，不要 fallback 到默认值——环境错配比启动失败更危险
结构体嵌套 + 环境专属字段要显式声明
避免用 map[string]interface{} 解析 YAML，它会让类型检查失效、IDE 失去跳转能力。用嵌套结构体明确区分通用字段与环境敏感字段：
type Config struct {
Server struct {
Port int `yaml:"port"`
} `yaml:"server"`
DB struct {
Host string `yaml:"host"`
Port int `yaml:"port"`
Name string `yaml:"name"`
User string `yaml:"user"`
Password string `yaml:"password"`
} `yaml:"db"`
Cache struct {
RedisAddr string `yaml:"redis_addr"`
} `yaml:"cache"`
}
// 环境专属字段不塞进主结构体，而是单独定义
type DevConfig struct {
Config
LogLevel string `yaml:"log_level"`
}
type ProdConfig struct {
Config
SentryDSN string `yaml:"sentry_dsn"`
}
这样既能复用通用字段，又让 IDE 和 go vet 能校验每个环境的必填项。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
解析时校验环境变量与文件存在性
常见错误是 GO_ENV=prod 但没放 config.prod.yaml，程序静默加载了空配置。必须主动检查：
- 先拼出预期文件路径：
./configs/config.+os.Getenv("GO_ENV")+.yaml - 用
os.Stat检查文件是否存在，不存在则log.Fatal("missing config file: ", path) - YAML 解析后，对生产环境强制校验
SentryDSN、数据库密码非空等字段，用if c.SentryDSN == "" && env == "prod" { ... }
测试环境不要共享开发配置
很多人把 test 当作 dev 的子集，直接复用 config.dev.yaml 并覆盖部分字段。这会导致测试跑在未隔离的数据库或缓存上。正确做法：
- 为
test单独建config.test.yaml，所有服务地址指向本地 Docker 容器（如redis://localhost:6380） - 测试启动前加检查：
if os.Getenv("GO_ENV") == "test" && os.Getenv("CI") != "true" { log.Fatal("test config only allowed in CI or local docker-compose") } - 单元测试中绕过文件加载，用
json.Unmarshal([]byte{...}, &c)直接构造测试用配置实例
环境差异最大的地方往往不是字段值，而是服务拓扑——这点容易被忽略，直到上线后连错 Redis 才发现。
