必须先调用viper.readinconfig()加载配置到内部map，再调viper.unmarshal(&cfg)绑定结构体；字段需导出且tag与配置key严格匹配，嵌套结构同理；automaticenv、setenvprefix等必须在readinconfig前调用，测试需viper.reset()隔离。
Unmarshal 结构体前必须显式调用 ReadInConfig()
只调用 viper.ReadInConfig() 不等于配置已进结构体——它只是把文件内容加载进 Viper 内部 map，字段仍是零值。必须紧接着调用 viper.Unmarshal(&cfg) 才能真正绑定。
- 结构体字段 tag 必须与 YAML/JSON key 严格匹配，比如
Port int `yaml:"port"`，大小写、下划线都不能错 - 嵌套结构体（如
Database struct{ Host string `yaml:"host"` }）能正常递归绑定，但外层字段名也要带 tag - 别在结构体定义里写初始化值（
Timeout int = 30是非法语法），默认值得用viper.SetDefault("server.timeout", 30) - 如果配置键含下划线（如
db_user），要么结构体字段也用db_user string `yaml:"db_user"`，要么提前调用viper.SetEnvKeyReplacer(strings.NewReplacer("_", "."))统一转义
环境变量和命令行参数不会自动生效，需手动启用
viper.ReadInConfig() 只读文件，不碰环境变量或 flag。想让 APP_SERVER_PORT=8080 覆盖配置文件里的 server.port，必须在 ReadInConfig() 前设置：
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
-
viper.SetEnvPrefix("APP")—— 否则AutomaticEnv()不知道该扫哪些变量 -
viper.AutomaticEnv()—— 必须放ReadInConfig()之前，否则注册失败 - 若用
viper.BindEnv("server.port", "APP_SERVER_PORT")，第二个参数必须完全匹配真实环境变量名（大小写敏感） - 环境变量值是字符串，
viper.GetInt("server.port")才会尝试转换；设成APP_SERVER_PORT="8080"（带引号）会导致返回 0
多环境配置不能靠自动发现，得手动控制文件名和加载顺序
Viper 不会自己猜你当前是 dev 还是 prod。要加载 config.prod.yaml，就得显式指定名字：
- 先用
os.Getenv("APP_ENV")拿到环境名，再viper.SetConfigName("config." + env) -
viper.AddConfigPath()可调多次，路径按添加顺序搜索，找到第一个就停 —— 不会合并同名文件 - 真要分层覆盖（base → prod → local），得手动
os.ReadFile读多个文件，再依次调viper.MergeConfig(bytes)，后加载的 key 会覆盖前面的 -
viper.WatchConfig()必须在ReadInConfig()成功后立即调用，否则监听无效
测试中 viper.Reset() 不是可选项，是必须项
因为 Viper 默认单例，单元测试之间会互相污染。一个测试里改了 viper.SetDefault() 或 AddConfigPath()，下一个测试可能拿到脏数据。
- 每个测试函数开头应调
viper.Reset()，清空所有 paths、defaults、overrides - 避免在
init()里调viper.AddConfigPath()，否则整个包测试都受影响 - 若用子实例（
viper.Sub("server")），它不继承父实例的AutomaticEnv()设置，得单独配 - 调试时加一句
viper.Debug()，能直接看到当前哪些源（file/env/flag）被加载了，比猜快得多
viper.Unmarshal() 就可能静默失败，字段全是零值，而你还在查 YAML 缩进有没有空格。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
