直接用 flag 或 os.Getenv 不够用，因多环境部署时配置分散、类型不安全、缺默认值和统一校验；需用 struct + Unmarshal 构建类型安全配置结构，支持优先级合并与显式校验。
为什么直接用 flag 或 os.Getenv 不够用
当服务从单机测试走向多环境部署（dev/staging/prod），硬编码或零散读取环境变量会迅速失控：配置项分散、类型不安全、缺少默认值兜底、无法统一校验。这时候需要一个集中管理、可扩展、带生命周期意识的配置结构。
Go 原生没有“配置框架”，但标准库的 flag、encoding/json、encoding/yaml 已足够支撑轻量可靠的配置模式，关键在组织方式。
用 struct + Unmarshal 构建类型安全的配置结构
把配置抽象为 Go 结构体，让编译器和 IDE 帮你检查字段名、类型、是否必填——这是最简单也最有效的起点。
- 字段必须导出（首字母大写），否则
json.Unmarshal或yaml.Unmarshal无法赋值 - 用 struct tag 显式声明映射关系：
`json:"db_host" yaml:"db_host"`，避免字段名大小写歧义 - 用指针字段（如
*string）区分“未设置”和“设为空字符串” - 在结构体上定义
Validate()方法，集中做业务级校验（比如Port必须在 1–65535）
type Config struct {
DBHost string `json:"db_host" yaml:"db_host"`
DBPort int `json:"db_port" yaml:"db_port"`
}
func (c *Config) Validate() error {
if c.DBHost == "" {
return fmt.Errorf("db_host is required")
}
if c.DBPort < 1 || c.DBPort > 65535 {
return fmt.Errorf("db_port must be between 1 and 65535")
}
return nil
}
如何合并多个配置源（文件 + 环境变量 + flag）
真实场景中，配置往往来自多个层级：基础配置文件（yaml）、环境差异化覆盖（env）、临时调试参数（flag）。Go 没有自动合并机制，必须手动按优先级叠加。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 约定优先级：flag > env > config file（越靠右越基础，越靠左越具体）
- 先加载文件，再用
os.Getenv覆盖对应字段（注意类型转换，strconv.Atoi等需容错） - 最后调用
flag.Parse()，用flag.Set()或结构体字段赋值完成最终覆盖 - 不要依赖第三方库自动“深合并”嵌套 map——容易掩盖字段覆盖逻辑，调试困难
例如，env 中设 DB_PORT=5433，就应明确执行 cfg.DBPort = 5433，而不是试图 merge 一个 map[string]interface{}
为什么不要过早引入 Viper 或其他配置库
Viper 常见问题包括：静默失败（比如 key 写错但不报错）、类型断言不安全（v.Get("port").(int) panic）、重载逻辑耦合过重、测试时难以 mock。
- 如果项目只需读一次配置且无热重载需求，原生
io.ReadFile+yaml.Unmarshal更透明 - 若需监听文件变化，用
fsnotify自己监听 + 重建结构体，比 Viper 的WatchConfig更可控 - 所有配置解析错误（文件不存在、格式错误、字段缺失）都应在启动早期 panic 或 os.Exit(1)，避免服务带病运行
复杂点在于环境差异的表达方式——是拆成多个 yaml 文件，还是用模板 + 变量替换？后者容易引入 shell 注入风险；前者则要求加载逻辑能按环境名自动选文件。这个决策比用什么库更重要。
