viper.unmarshal(&cfg)是最省事方案，需显式setconfigtype、字段首字母大写并配正确tag（如yaml:"db_host"），否则静默失败。
用 viper 解析 YAML/JSON/TOML 到结构体最省事
Go 原生不支持直接把配置文件映射到结构体，viper 是事实标准。它能自动处理文件读取、格式解析、环境变量覆盖、默认值回退，比手写 json.Unmarshal 或 yaml.Unmarshal 稳定得多。
常见错误是没调用 viper.SetConfigType 就直接 ReadInConfig，导致报错 Unsupported Config Type ""；或者结构体字段没加正确的 tag（比如 yaml:"db_host"），结果字段始终为空。
- 初始化时必须显式设置格式：
viper.SetConfigType("yaml")（即使文件后缀是.yml） - 结构体字段需小写 +
exported（首字母大写），并带对应 tag：DBHost string `yaml:"db_host" json:"db_host"` - 推荐用
viper.Unmarshal(&cfg)而非viper.Get逐个取值，前者会做类型转换和嵌套结构展开 - 如果配置有层级（如
database.url），结构体得用嵌套 struct，不能全平铺
Unmarshal 失败但没报错？检查字段导出性和 tag 匹配
viper.Unmarshal 默认静默失败：字段名或 tag 对不上，就跳过，不会 panic 也不会 warn。你看到结构体字段是零值，大概率是字段没导出，或 tag 写错了大小写、下划线/驼峰不一致。
比如 YAML 里写的是 redis_port: 6379，结构体字段定义成 RedisPort int `yaml:"redisport"`（漏了下划线），值就不会被赋上。
- 所有要绑定的字段必须首字母大写（
Port，不是port） - tag 中的 key 必须和配置文件里完全一致（包括大小写、连字符、下划线）
- 可以用
viper.AllKeys()打印所有已加载的 key，对照检查拼写 - 临时加一句
if err := viper.Unmarshal(&cfg); err != nil { log.Fatal(err) }强制暴露问题
不用 viper 时，手写 yaml.Unmarshal 的关键步骤
如果项目禁止引入第三方库，就得自己读文件 + 解析。这时容易忽略文件路径是否正确、字节流是否为空、结构体 tag 是否统一。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
YAML 和 JSON 的解析逻辑几乎一样，只是 import 的包不同；TOML 需额外加 github.com/pelletier/go-toml/v2。
- 先用
os.ReadFile("config.yaml")读字节，别用os.Open+ioutil.ReadAll（后者已弃用） - 传给
yaml.Unmarshal(data, &cfg)，不是yaml.Unmarshal([]byte("..."), &cfg)（硬编码字符串易错） - 确保结构体字段 tag 是
yaml:"xxx"，而不是json:"xxx"（混用会导致静默失败） - 嵌套 map 或 slice 字段，需要对应 struct 字段类型一致，比如 YAML 中
features: [login, pay]→Features []string `yaml:"features"`
环境变量覆盖配置时，viper.AutomaticEnv() 不够用
viper.AutomaticEnv() 只能按字段名原样映射，比如结构体字段 DBHost 会去找环境变量 DBHOST。但实际部署中，环境变量常带前缀（如 APP_DB_HOST），这时必须手动绑定。
否则你会发现本地跑得好好的，K8s 里环境变量明明设置了，结构体还是用的 config 文件里的默认值。
- 调用
viper.BindEnv("database.host", "APP_DB_HOST")显式绑定 - 字段路径用点号分隔（对应嵌套结构），不是结构体字段名
- 绑定要在
viper.ReadInConfig()之前，否则可能被覆盖 - 测试时可用
viper.Get("database.host")直接验证最终值，比看结构体更可靠
真正麻烦的从来不是解析动作本身，而是配置来源混合（文件 + 环境变量 + 命令行参数）时的优先级混乱，以及嵌套结构体 tag 和配置 key 之间那几个下划线或大小写的偏差——它们不会报错，只会让程序在某个环境里悄悄用错值。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
