goland 运行配置中设 env=dev 需在 environment variables 栏手动填写，并勾选 include system environment variables，否则 os.getenv("env") 返回空字符串；同时 viper 要动态拼接 setconfigname("config-" + os.getenv("env")) 并确保结构体字段首字母大写且带正确 yaml 标签。
GoLand 运行配置里怎么设 ENV=dev 才生效
GoLand 的运行配置（Run Configuration）中，环境变量必须在 Environment variables 栏显式填写，不能只靠终端 export 或 .env 文件自动加载。常见错误是写了 ENV=dev 却没点「Include system environment variables」旁边的复选框，导致 Go 程序读不到。
实操建议：
- 打开 Run → Edit Configurations → 选中你的 Go 应用 → 右侧填
ENV=dev（推荐小写，避免大小写敏感问题） - 务必勾选
Include system environment variables，否则os.Getenv("ENV")返回空字符串 - 如果同时用
viper.AutomaticEnv()，建议额外加APP_ENV=dev并配viper.SetEnvPrefix("APP")，避免和系统变量冲突 - 启动后加一行
log.Println("ENV:", os.Getenv("ENV"))验证是否真读到了，别只信配置界面显示
viper.SetConfigName 必须拼接 ENV，不能硬编码
viper.ReadInConfig() 不会自动识别 ENV=dev 就去加载 config-dev.yaml；它只按 viper.SetConfigName() 当前值找文件，且只找第一个匹配项。写死 viper.SetConfigName("config-prod") 切环境就报 Config File Not Found。
正确做法：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 在
viper.ReadInConfig()前调viper.SetConfigName("config-" + os.Getenv("ENV")) - 确保
os.Getenv("ENV")非空，否则拼出config-.yaml—— 这种文件名几乎不存在 -
viper.AddConfigPath("./configs")的路径末尾不要加斜杠，写成"./configs/"可能导致拼出"./configs//config-dev.yaml"，触发文件未找到 - 调
viper.SetConfigType("yaml")显式指定类型，否则可能报Unsupported Config Type ""
嵌套字段如 database.host 怎么被 DATABASE_HOST 覆盖
默认情况下，viper.AutomaticEnv() 只把 DB_HOST 映射到顶层 key db_host，完全不理解 . 分隔的嵌套结构。所以即使 YAML 里写了 database: { host: localhost }，DATABASE_HOST=127.0.0.1 也覆盖不了。
必须组合两步：
- 调
viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))，让database.host→DATABASE_HOST - 调
viper.SetEnvPrefix("app")（可选但推荐），这样app.database.host对应APP_DATABASE_HOST，避免和别的服务撞变量名 - 如果环境变量名不规范（比如直接用
PGHOST），就用viper.BindEnv("database.host", "PGHOST")显式绑定，绕过命名规则
结构体字段小写 = 静默失效，不是报错
YAML 解析失败最常表现为字段值是零值（0、空字符串、nil），而不是 panic 或 error。根本原因是 Go 反射只能访问首字母大写的导出字段 —— 写 port int 就会被 yaml.Unmarshal 完全忽略。
关键检查点：
- 结构体字段必须大写：如
Port int，不能是port int - 每个字段都要加
yaml:"port"标签，且键名大小写要和 YAML 文件里完全一致（yaml:"Port"只匹配Port: 8080，不匹配port: 8080） - 嵌套结构体内部字段也要大写 + tag，不能只导出顶层字段
- 用
gopkg.in/yaml.v3，别用已归档的v1或有 bug 的v2；安装命令是go get gopkg.in/yaml.v3（注意路径含.v3）
SetConfigName 是否动态拼接、结构体字段是否导出——这三处任一出错，都会导致配置“看起来读了，其实没生效”。
