日志级别字段读不到是因为Viper未正确映射嵌套配置到结构体字段。需确保结构体字段导出、带正确viper tag（如viper:"level"），嵌套结构逐层定义；环境变量生效需在ReadInConfig前设置SetEnvPrefix、SetEnvKeyReplacer和AutomaticEnv；Zap日志级别须在配置加载后动态构建；config.local.yaml覆盖需保持相同嵌套结构。
日志级别字段为什么总读不到？
不是 viper 没加载，而是它默认不把配置项映射到结构体字段——尤其日志级别这种常被写成 logger.level 的嵌套路径。你用 viper.GetString("logger.level") 能拿到值，但用 viper.Unmarshal(&cfg) 时，如果结构体里没写对 tag，字段就为空。
常见错误：结构体字段叫 LogLevel，却没加 viper:"level" tag；或者嵌套结构没逐层定义，比如 Logger 字段类型是 struct{ Level string }，但没导出、没 tag、没初始化。
- 结构体字段必须首字母大写（导出），且显式声明
viper:"level"或viper:"logger.level" - 嵌套结构不能靠点号自动展开：
Logger.Level对应的 tag 必须是viper:"level"，不是viper:"logger.level" - 如果配置文件里写的是
logger: { level: "debug" }，结构体就得定义Logger LoggerConfig `viper:"logger"`，再在LoggerConfig里写Level string `viper:"level"`
ENV=prod 时日志级别还是 debug？
环境变量没生效，多半是因为 viper.AutomaticEnv() 调得太晚，或没配 SetEnvKeyReplacer 和 SetEnvPrefix。比如你希望 APP_LOGGER_LEVEL=info 覆盖配置文件里的 debug，但没做映射，viper 就根本不会去查这个变量。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 必须在
viper.ReadInConfig()之前调用viper.SetEnvPrefix("APP") - 紧接着调
viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))，否则APP_LOGGER_LEVEL不会匹配到logger.level -
viper.AutomaticEnv()也得在ReadInConfig()前调，顺序错了就失效 - 验证方法：启动后打印
viper.Get("logger.level")，看是不是你设的环境变量值
怎么让 Zap 日志级别随配置自动变？
Zap 初始化只跑一次，所以不能等 viper.Unmarshal 完再建 logger——得先加载配置，再根据 cfg.Logger.Level 构造 zapcore.Level，最后传给 zap.NewCore()。
- 别在
init()里初始化 logger，否则测试时无法 mock 配置 - 把 logger 初始化逻辑拆到单独函数，接收已解析的配置结构体
- 用
zapcore.Level.UnmarshalText([]byte(cfg.Logger.Level))把字符串转成 level 值，失败要提前 panic - 开发环境建议用
zapcore.DebugLevel，生产环境强制校验：如果cfg.Logger.Level不是"info"或"error"，直接退出
config.local.yaml 覆盖日志级别无效？
viper.MergeInConfig() 不会自动合并嵌套字段——如果主配置 config.yaml 里写了 logger: { level: "debug" }，而 config.local.yaml 只写 level: "warn"（没包在 logger: 下），那 merge 后还是 debug。
-
config.local.yaml必须保持和主配置相同的嵌套结构：logger: { level: "warn" } - 调用
MergeInConfig()前，先用os.Stat()判断文件是否存在，避免 panic - 本地覆盖配置只用于开发，CI/CD 流水线里要禁用
config.local.yaml，全靠环境变量注入 - 验证方式：启动后打印
viper.AllSettings()，确认logger.level的最终值
viper 不会猜你想做什么，它只认 tag、前缀、替换规则这三样。少一个，日志级别就卡死在默认值上。 
