viper.ReadInConfig()报config not found错误是因为默认不搜索当前目录，必须显式调用AddConfigPath(".")；SetConfigName设文件名不含扩展名，SetConfigType需显式声明类型。
为什么viper.ReadInConfig()总返回config not found错误
不是路径写错，也不是文件名不对，而是viper默认不主动搜索当前目录——它只认你显式AddConfigPath()加进去的路径。哪怕config.yaml就放在main.go同级，不调用viper.AddConfigPath(".") 或viper.AddConfigPath("./")，它根本不会看。
-
viper.SetConfigName("config")只设文件名，不含扩展名；viper.SetConfigType("yaml")必须显式声明，否则无法识别YAML语法 - 多个
AddConfigPath()会按添加顺序从左到右查找，第一个命中即停，不会合并 - 如果用了
viper.SetConfigFile("/etc/myapp/config.yaml")，就别再调AddConfigPath()，二者互斥 - Windows下路径分隔符用
/或\都行，但.开头的相对路径必须带./，不能只写.
结构体绑定时viper.Unmarshal()字段全为空怎么办
常见原因是结构体字段没导出（首字母小写），或者JSON/YAML key和struct tag对不上。viper反序列化只处理导出字段，且严格依赖tag里的键名映射。
- 确保所有字段首字母大写，例如
Port int `json:"port"`，而不是port int - YAML里写
server-port: 8080，结构体就得用ServerPort int `yaml:"server-port"`，大小写和连字符必须完全一致 - 嵌套结构体要逐层打tag：
Database DatabaseConfig `yaml:"database"`，不能漏掉外层key - 如果配置项可能缺失，用指针字段（如
*string）或omitemptytag避免零值覆盖
本地开发用.env，生产环境为什么不能直接godotenv.Load()
因为godotenv.Load()会把.env里所有变量无差别注入进程环境，包括HOME、PWD甚至PATH——这些系统变量一旦被覆盖，可能导致子进程执行失败或路径解析异常。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 仅在
GO_ENV != "production"时调用godotenv.Load()，上线前必须删掉或注释掉这行 -
.env文件必须进.gitignore，且严禁放密码、密钥等敏感值（它们应由K8s Secret或Dockerenvironment字段注入） - Docker Compose中
env_file:和environment:共存时，后者优先级更高，environment里定义的变量会覆盖env_file里的同名项 - 若用
viper.AutomaticEnv()，务必配合viper.SetEnvPrefix("APP")，否则HOME=/root会被映射成home字段，静默污染配置
环境变量和配置文件混用时，谁的优先级更高
viper默认按“环境变量 > flag > config file > default”顺序覆盖，但这个顺序可被干预——关键是调用viper.BindEnv()后，对应字段就锁定为环境变量源，不再读配置文件同名项。
立即学习“go语言免费学习笔记（深入）”；
- 先调
viper.BindEnv("server.port", "PORT")，再viper.ReadInConfig()，即使config.yaml里有server.port: 9000，最终取的仍是PORT环境变量值 - 没
BindEnv()的字段才走文件 fallback；没SetDefault()又没配置来源的字段，viper.GetInt()会返回0，viper.GetString()返回空字符串，不报错 - 调试时用
viper.AllSettings()打印全部生效配置，比猜更可靠 - 线上服务启动前建议校验必填项：
if viper.GetInt("server.port") == 0 { log.Fatal("server.port is required") }
ReadInConfig()之后再BindEnv()无效；而SetDefault()必须在ReadInConfig()之前调用，否则会被配置文件内容覆盖。 
