viper.Unmarshal字段全为零值主因是结构体字段未导出、缺失mapstructure标签或嵌套外层无tag；需确保字段首字母大写、显式添加mapstructure:"key"、所有嵌套层级均带tag。
viper 是 Go 项目中处理 YAML 配置与环境依赖注入最常用、也最易出错的工具。它本身不强制你做对的事，但一旦配置路径、结构体标签或加载时机错了，就会静默失败——比如 viper.Unmarshal 返回 nil 错误，字段却全是零值，日志里什么提示都没有。
为什么 viper.Unmarshal 总是把字段设成零值？
这不是 bug，是反射匹配失败的典型表现，常见原因有三个：
- 结构体字段没导出（首字母小写），
viper完全看不到，直接跳过 -
mapstructuretag 拼写错误或缺失，比如写成yaml:"port"或漏掉mapstructure:"port" - 嵌套结构体外层没加 tag，比如
Redis RedisConfig `mapstructure:"redis"`缺了这行，内层字段再对也进不来
验证方式很简单：viper.Get("redis.port") 能取到值，但 viper.Unmarshal(&cfg) 不行 → 问题一定出在 struct tag 或字段导出上。
viper.SetConfigName 和 AddConfigPath 怎么配才不报 Config File Not Found？
路径必须显式指定，viper 不会自动猜。常见错误是只调 SetConfigName("config") 却没告诉它去哪找。
立即学习“go语言免费学习笔记（深入）”；
-
AddConfigPath(".")：从当前工作目录（os.Getwd()）开始搜，适合开发时go run main.go -
AddConfigPath(filepath.Dir(os.Executable()))：从二进制所在目录搜，适合打包后部署 - 如果配置文件在
./conf/config.yaml，就用AddConfigPath("./conf")，别写成AddConfigPath("conf")—— 前者是相对当前目录，后者是相对执行路径，行为不一致 - 调试时加一句
fmt.Println(viper.ConfigFileUsed())，立刻知道它到底加载了哪个文件
环境变量怎么覆盖 YAML 里的 database.port？
不是写了 AUTOMATIC_ENV 就自动生效。默认情况下，APP_DATABASE_PORT 不会映射到 database.port，必须手动搭桥。
- 先调
viper.SetEnvPrefix("APP")，否则所有环境变量都被忽略 - 再调
viper.AutomaticEnv()，这时APP_DATABASE_PORT才会转成database.port - 如果想更精确控制，用
viper.BindEnv("database.port", "APP_DB_PORT")，这样APP_DB_PORT=3307就能覆盖 YAML 里的值 - 注意：环境变量值始终是字符串，
viper.GetInt("database.port")会尝试转换，失败就返回 0，不报错 —— 所以建议加个viper.IsSet("database.port")判断是否真被设置了
IOC-golang 的 config:",autowire.config.service.timeout" 标签为什么总匹配不上？
路径匹配是严格层级展开，不是字符串模糊查找。YAML 里一个空格缩进错误，整个 autowire.config 节点就不存在。
- YAML 必须用空格缩进，禁止 tab；
retry-count这种带连字符的 key，在 struct tag 里写config:",autowire.config.service.retry-count"是合法的，但不如统一用下划线稳妥 - 字段类型要和 YAML 值类型一致：YAML 写
timeout: 5s，Go 字段就得是Timeout time.Duration，不能是*config.ConfigString—— 后者只存原始字符串，不做解析 -
config:标签里的路径必须完整，不能省略autowire.前缀，也不能把autowire.config.service.timeout简写成service.timeout
真正麻烦的不是语法，而是 YAML 解析后结构和 Go struct 层级不一致 —— 这种错没法靠编译器发现，只能靠 viper.AllKeys() 或打印 viper.AllSettings() 对比确认。
