Go解析YAML配置文件总panic，主因是结构体字段未导出：字段必须首字母大写（如Port int）、显式标注yaml:"key"标签，且传指针&cfg、用os.ReadFile读取并检查错误；嵌套字段同理，YAML键名须与标签严格一致（含大小写、下划线）。
Go 里读 YAML 配置文件总 panic？先检查 viper.Unmarshal 的结构体字段是否导出
Go 解析配置最常踩的坑不是语法错，而是结构体字段没大写——viper.Unmarshal 只能写入导出字段（首字母大写）。如果字段是 port int 而非 Port int，值永远为零，也不报错，只默默忽略。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 所有待绑定的字段必须首字母大写，且类型要和 YAML 中的实际值匹配（比如
timeout: 30对应Timeout int，不是string） - 用
viper.SetDefault("key", value)预设兜底值，避免字段缺失导致空指针或零值误用 - 解析后立刻用
if err := viper.Unmarshal(&cfg); err != nil检查错误，别跳过
用 go-yaml/yaml 直接解码比 Viper 更轻量，但要注意 yaml.Unmarshal 不支持嵌套键自动展开
Viper 支持 viper.GetString("server.port") 这种点号路径访问，而原生 yaml.Unmarshal 只认结构体嵌套。如果你的 YAML 是扁平的（如 log_level: debug），却定义了嵌套结构体，就会解码失败或字段为空。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 直接解码时，结构体层级必须和 YAML 层级严格一致；想用点号路径，要么改结构体，要么坚持用 Viper
-
yaml.Unmarshal默认不处理字段别名，需显式加 tag：Port int `yaml:"server_port"` - 时间字段容易出错：YAML 里的
2024-01-01默认被解析成字符串，需用time.Time+ 自定义UnmarshalYAML方法
viper.ReadInConfig() 找不到文件？路径、工作目录和注册格式三者必须同时对上
Viper 不会自动猜你把 config.yaml 放在哪。它默认在当前工作目录（不是源码目录）找 config.yaml，且必须提前用 viper.SetConfigType("yaml") 告诉它格式，否则即使文件存在也会报 Unsupported Config Type ""。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用绝对路径更可控：
viper.SetConfigFile("/etc/myapp/config.yaml")，避免依赖os.Getwd() - 若用
viper.AddConfigPath()，注意它只影响viper.ReadInConfig()，不改变viper.SetConfigFile()的行为 - 调试时加一句
fmt.Println("Config path:", viper.ConfigFileUsed())，确认它真读到了哪个文件
环境变量覆盖配置时，viper.AutomaticEnv() 不生效？检查前缀和命名转换规则
viper.AutomaticEnv() 默认把结构体字段 HttpPort 映射到环境变量 HTTPPORT，不是 HTTP_PORT。如果你设的是 export HTTP_PORT=8080，Viper 就看不到。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 调用
viper.SetEnvPrefix("APP")后，Port字段对应环境变量是APP_PORT，不是PORT - 启用
viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))才能让server.port匹配SERVER_PORT - 环境变量优先级高于配置文件，但低于
viper.Set()显式设置的值——这点容易被忽略，导致线上配置被本地Set覆盖
