viper.setdefault()必须在viper.readinconfig()之前调用，否则默认值完全无效；其机制是lazy的，仅在键首次被viper.get*访问且内存中无该键时生效，优先级为环境变量>配置文件>默认值。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
先调 viper.SetDefault()，再读配置文件
默认值不会“自动兜底”已加载的配置，viper.SetDefault() 必须在 viper.ReadInConfig() 之前调用，否则完全无效。Viper 的默认值是 lazy 的：只有某个键首次被 viper.Get* 访问、且当前内存中无该键时，才查默认值表。一旦 ReadInConfig() 执行完，所有键的状态就固化了——哪怕配置文件里根本没写 timeout，后续 viper.GetInt("timeout") 也不会触发默认逻辑。
- 正确顺序必须是：
viper.SetDefault("db.host", "localhost")→viper.AddConfigPath(...)→viper.ReadInConfig() - 嵌套键如
cache.redis.url，默认值路径必须完整，漏掉redis.就静默失效 - 用
viper.Unmarshal(&cfg)时，结构体字段名和mapstructuretag 必须严格匹配默认值路径（比如mapstructure:"host"对应"db.host"，不是"DB.Host"） - 字段未导出（小写开头）会导致 Viper 无法写入，也不报错，字段永远为零值
go-ini 读 [section.sub] 节名不等于嵌套结构
go-ini 把 [database.mysql] 当作一个独立节名字符串处理，不会自动挂载到 database 下，也没有继承或 fallback 机制。[database] 和 [database.mysql] 的键互不影响。想复用共用字段（比如 host），得手动 fallback：
- 先查
cfg.Section("database.mysql").Key("host").String() - 为空时再查
cfg.Section("database").Key("host").String() - 别依赖点号自动解析——
cfg.Section("database.mysql")和cfg.Section("database/mysql")是两个完全无关的节 - 对带单位的值（如
timeout = 30s），Key("timeout").Int64()会返回 0；应改用Key("timeout").String()+time.ParseDuration() - 所有
Key().Xxx()方法都不 trim 空格，需要干净字符串就得自己strings.TrimSpace()
用反射 + default tag 填充结构体零值字段
Go 结构体字段没有内置默认值机制，但可通过 reflect 遍历字段、检查 default tag 并在字段为零值时填充。这种方式适合统一处理大量字段，但要注意：
- 字段必须导出（大写开头），否则
reflect.Value.CanSet()返回 false，写入失败且静默 - 指针字段需先
reflect.New()初始化，再递归处理其元素 - 数组、切片类型不支持直接设默认值（如
[]string无法用 tag 表达），需在构造函数中显式初始化 - 标签值是字符串，数字/布尔需手动
strconv转换，bool还要兼容"true"/"1"等写法 - 别在 JSON 反序列化后才做默认值填充——
json.Unmarshal会把缺失字段设为零值，但无法区分“上游没传”和“上游传了空值”，建议在 unmarshal 前或用*string等指针类型保留 nil 状态
环境变量空字符串会跳过默认值
viper.AutomaticEnv() 开启后，只要环境变量存在（哪怕值为空），就会跳过默认值。优先级永远是：环境变量 > 配置文件 > 默认值。典型问题：
-
os.Setenv("APP_LOG_LEVEL", "")+viper.GetString("log.level")返回空字符串，不是默认的"info" - 想让空环境变量退回到默认值？必须手动判断：
if viper.GetString("log.level") == "" { ... } - 若需精确控制映射关系（比如
log.level对应LOG_LEVEL，而非自动转成LOG_LEVEL），别用AutomaticEnv()，改用viper.BindEnv("log.level", "LOG_LEVEL") -
viper.SetEnvPrefix("APP")后，viper.BindEnv("log.level", "LOG_LEVEL")会绑定到APP_LOG_LEVEL，不是LOG_LEVEL—— prefix 仍生效
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
