Go原生不自动加载.env文件，必须用godotenv.Load()在main()开头显式调用并检查错误，否则os.Getenv()将返回空；多文件需手动指定顺序加载，且生产环境应禁用.env改用运行时注入。
Go 读取 .env 文件：用 godotenv 加载环境变量最直接
go 原生不支持自动加载 .env 文件，必须借助第三方库。最常用、最轻量的是 github.com/joho/godotenv，它只做一件事：把 .env 中的键值对注入 os.environ()，后续调用 os.getenv() 就能拿到。
常见错误是没处理加载失败却继续运行，导致配置为空；或者在 main() 之外（比如 init 函数里）提前调用 os.Getenv()，此时 godotenv.Load() 还没执行。
- 推荐在
main()开头立即调用godotenv.Load()，并检查错误：if err := godotenv.Load(); err != nil { log.Fatal("加载 .env 失败:", err) } - 如果
.env不在当前目录，传入完整路径：godotenv.Load(".config/.env") - 多个文件可依次加载：
godotenv.Load(".env.local", ".env")，后加载的会覆盖前面同名变量 - 注意：该库不会解析变量引用（如
PORT=${HTTP_PORT}），需要手动用godotenv.Expand()或换用dotenv库
Go 读取 YAML 配置：用 gopkg.in/yaml.v3 解析结构体最稳妥
YAML 比 .env 更适合复杂配置（嵌套、数组、类型明确），但 Go 没有内置支持，必须用 gopkg.in/yaml.v3（v2 已归档，v3 是当前维护版本）。关键点不是“能不能读”，而是“怎么映射到结构体才不出错”。
典型坑是字段名大小写不匹配或缺少 struct tag，导致解析后字段为零值；或者 YAML 中用了缩进空格不一致，触发解析 panic。
- 结构体字段必须首字母大写（导出），且加
yaml:"key_name"tag，例如：type Config struct { Server struct { Port int `yaml:"port"` Host string `yaml:"host"` } `yaml:"server"` } - 用
ioutil.ReadFile（Go 1.16+ 推荐os.ReadFile）读取文件内容，再传给yaml.Unmarshal() - YAML 中布尔值写成
true/false，数字不要加引号，否则可能被当字符串解析 - 如果配置项可选，字段类型建议用指针（如
*string）或加omitemptytag，避免零值覆盖默认逻辑
同时支持 .env 和 YAML：优先级和合并逻辑得自己控制
没有标准方案能自动“混合加载”两种格式。常见做法是先读 YAML 构建基础配置，再用 .env 覆盖其中部分字段（比如只覆盖敏感信息或本地调试参数）。顺序和覆盖规则必须显式编码，不能依赖库默认行为。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
容易忽略的是环境变量名和 YAML key 的命名差异：YAML 习惯用 snake_case，而环境变量通常全大写加下划线（DB_HOST），需做映射转换。
- 建议定义统一的配置结构体，YAML 和环境变量都映射到它，例如：
DBHost string `env:"DB_HOST" yaml:"db_host"` - 可用
github.com/mitchellh/mapstructure把 map[string]interface{}（来自 YAML）和os.Environ()同时解码进同一结构体，但要注意类型转换失败的 fallback - 生产环境通常禁用
.env，只靠环境变量；开发时两者共存，此时务必在文档里写清优先级：env > YAML - 不要在 YAML 里写密码等敏感字段——这类值应只通过环境变量注入
为什么不用 viper？它太重，且隐藏行为多
viper 确实支持多种格式和自动重载，但它引入了隐式行为：自动搜索路径、缓存机制、键名 normalize（如把 API_URL 当作 api-url）、以及难以调试的优先级链。小项目或 CLI 工具中，这些特性反而增加不确定性。
真实问题常出现在：修改了 .env 但程序没重启，误以为 viper 自动热重载；或 YAML 中写了 log-level: debug，却被 viper.Get("log_level") 取不到——因为 key 被 normalize 成了 loglevel。
- 除非你明确需要远程配置中心（etcd/Consul）或文件监听重载，否则绕过 viper
- 如果已用 viper，务必调用
viper.SetEnvKeyReplacer(strings.NewReplacer("-", "_"))统一环境变量风格 - 调试时用
viper.AllSettings()打印最终配置，而不是只查单个 key
真正难的不是读取，而是让不同环境下的配置来源清晰、不可变、可审计。YAML 适合描述性配置，.env 适合运行时注入，混用时一定要明确定义哪一层负责什么，别让加载逻辑散落在多个 init 函数里。
