viper.setdefault() 必须在 viper.readinconfig() 和任何 get* 调用前设置，否则失效；它仅在键首次访问且未从任何源加载时生效，不覆盖空字符串、零值或已设的环境变量/yaml null 值。
默认值必须在 viper.ReadInConfig() 或任何 viper.Get* 调用前设置，否则完全失效。 Viper 不会“补设”或回溯查找，默认值只在键首次被访问且尚未从任何源（文件、环境变量、命令行等）加载时才生效。一旦配置已加载（哪怕该 key 在文件里根本没出现），后续再调 viper.SetDefault() 就毫无作用。
为什么 viper.SetDefault() 看似不生效
常见现象是：写了 viper.SetDefault("timeout", 30)，但 viper.GetInt("timeout") 返回 0 或 panic。原因通常有：
- 先调了
viper.ReadInConfig()，再调SetDefault()—— 此时所有键状态已固化，Viper 认为“该 key 已明确未定义”，不再查默认值表 - 环境变量
TIMEOUT存在（哪怕值为空字符串""）且启用了viper.AutomaticEnv()—— 环境变量优先级高于默认值，空字符串也会覆盖默认值 - 配置文件中写了
timeout: null或timeout:（YAML 中的空值），Viper 解析后得到零值（如0、""），它不认为这是“未设置”，而是“已设置为零值” - 结构体字段已有初始值（如
Timeout int = 0），再用viper.Unmarshal(&cfg)时，Viper 默认不覆盖已有零值
viper.SetDefault() 支持哪些类型和嵌套写法
支持任意 Go 类型：基本类型、[]string、map[string]interface{}、甚至嵌套 map。关键在于路径写法必须匹配最终解析时的 key 名：
- 顶层字段：
viper.SetDefault("port", 8080) - 嵌套字段（YAML 中
db.host: localhost）：viper.SetDefault("db.host", "localhost")，不是"DB.Host"或"db.Host" - 复杂结构：
viper.SetDefault("features", []string{"auth", "metrics"}) - 嵌套 map：
viper.SetDefault("kafka", map[string]interface{}{"host": "127.0.0.1", "port": 9092})
注意：如果之后用 viper.Unmarshal(&cfg) 映射到 struct，struct 字段的 mapstructure tag 必须与这里设默认值的路径一致，例如 Host string `mapstructure:"host"` 对应 "db.host"，而非 "db.Host"。
空字符串、false、0 怎么兜底
Viper 不做语义判断 —— 它把 ""、"false"、"0" 都当作合法字符串值，不会自动 fallback 到默认值。需要手动检查：
- 对字符串：
if viper.GetString("api.url") == "" { /* use default logic */ } - 对布尔值：
if !viper.GetBool("feature.enabled") { /* treat as disabled, but note: "false" string also yields false */ }—— 更稳妥是统一用字符串比较：viper.GetString("feature.enabled") == "true" - 对数字：
if viper.GetInt("timeout") == 0 { /* assume not set, use default */ }，但前提是业务上 0 确实是非法值
真正安全的做法是：在 viper.ReadInConfig() 后，用 viper.AllKeys() 或 viper.Get("key") == nil 判断键是否“未被任何源设置”，再决定是否启用默认逻辑。不过这绕过了 Viper 内置机制，适合关键字段的强校验。
最容易被忽略的一点：默认值不是“保底输出”，而是“首次访问时的初始化策略”。只要键被任何方式写入过内存（包括空环境变量、YAML 中的 null、viper.Set() 赋零值），Viper 就永远不会再给你默认值。别指望它自动救场，得靠你提前卡好时机、写对路径、并为 falsy 字符串单独兜底。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
