viper.setdefault仅在键未被任何来源设置时生效；readinconfig需预设名称、路径和类型；automaticenv依赖键名转换规则；unmarshal需为导出字段添加mapstructure tag。
为什么 viper.SetDefault 不生效？
因为默认值只在键未被显式设置（包括环境变量、配置文件、命令行参数等所有来源）时才起作用。一旦任何来源设置了该键，viper.SetDefault 就完全被忽略。
- 常见错误：先调用
viper.SetDefault("port", 8080)，再用viper.SetConfigFile("config.yaml")加载含port: 0的文件 → 最终viper.GetInt("port")返回0，不是8080 - 正确做法：确保默认值是“兜底逻辑”，所有外部配置应明确覆盖或留空；若需强制 fallback，改用
viper.GetInt("port")后手动判断是否为零值 - 注意：环境变量优先级高于默认值，且大小写敏感（
APP_PORT和app_port是两个键）
如何让 viper.ReadInConfig 正确加载 YAML/JSON/TOML？
必须提前设置配置名、路径和类型，否则 viper.ReadInConfig 会静默失败或报错 Config File "config" Not Found in "[.]"。
- 先调用
viper.SetConfigName("config")（不含后缀） - 再调用
viper.AddConfigPath("./configs")或viper.AddConfigPath(".")，路径必须存在且可读 - 显式指定格式：
viper.SetConfigType("yaml")（尤其当文件无扩展名或扩展名不标准时） - YAML 中注释和缩进错误（如 tab 混入空格）会导致解析失败，错误信息是
While parsing config: yaml: line X: did not find expected key
环境变量自动绑定为什么有时拿不到值？
viper.AutomaticEnv() 只负责“启用查找”，不自动映射键名；实际能否命中，取决于环境变量名与配置键的转换规则。
- 默认规则：把
.和-替换为_，全大写 →server.port对应SERVER_PORT，log-level对应LOG_LEVEL - 如果键名含大写字母（如
apiUrl），默认规则无法匹配，需用viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_", "-", "_"))预处理，或统一用小写命名配置项 - 注意：环境变量在
viper.ReadInConfig()之前还是之后读取都行，但viper.Unmarshal()会按最终合并后的值解构，无需额外操作
用 viper.Unmarshal 解析嵌套结构体总 panic？
根本原因是结构体字段没加 json 或 mapstructure tag，viper 默认用 mapstructure 解析，而 Go 的匿名嵌入、私有字段、类型不匹配都会导致解构失败。
- 必须给每个导出字段加上
mapstructure:"key_name"tag，例如：Port int `mapstructure:"port"` - 嵌套结构体要逐层打 tag，不能只打顶层；
type Config struct { Server ServerConfig `mapstructure:"server"` } - 切片和 map 类型需确保配置源中对应字段存在且类型一致（YAML 中
[]和{}写错一个字符就会 panic） - 调试技巧：先用
viper.AllSettings()打印最终合并的 map，确认键名和值类型是否符合预期
最常被忽略的是 tag 名和配置键名大小写的严格对应——viper 不做任何大小写归一化，mapstructure:"DB_URL" 和环境变量 db_url 是两回事。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
