YAML配置仅影响iris.Application初始化行为，业务参数不应混入；路径需显式指定，如"./configs/iris.yml"；字段名严格区分大小写且不支持snake_case；YAML不解析环境变量占位符；框架与业务配置应分离管理。
YAML 配置只影响 iris.Application 初始化阶段的行为，业务参数（如数据库地址、API 密钥）不该塞进去——这是最常被误用的点。
用 iris.YAML 加载配置文件时路径必须显式指定
它不会自动查找 ./config 或 ./configs 目录，传入的字符串就是完整路径（含文件名），相对路径以当前工作目录为基准。
- 常见错误：写
"iris.yml"却在非项目根目录下执行go run main.go或运行二进制，导致文件打不开且静默失败 - 推荐写法：
iris.YAML("./configs/iris.yml")，确保该路径对执行位置可读 - 跨环境统一路径可结合
os.Getenv("CONFIG_PATH")，例如iris.YAML(os.Getenv("CONFIG_PATH")) - 调试时加一行
fmt.Println("loading config from:", "./configs/iris.yml")，避免配置加载失败却无提示
iris.Configuration 字段名严格区分大小写且不支持 snake_case
Iris 的配置结构体字段名必须与源码中定义的完全一致，多出或写错的字段会被忽略，缺失关键字段也不会报错，但行为可能异常（比如 FireMethodNotAllowed 没开，405 错误就不返回）。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 正确示例：
DisableStartupLog: true、TimeFormat: "2006-01-02 15:04:05" - 错误写法：
disable_startup_log: true（snake_case 不识别）、log_level: "info"（Iris 不处理该字段） - 字段名大小写敏感，
firemethodnotallowed或FireMethodnotallowed均无效
YAML 文件里不能直接写 ${PORT} 这类环境变量占位符
Iris 不做 shell 式变量展开，Addr: ":${PORT}" 会被原样当作字符串加载，最终监听地址变成字面量 ":${PORT}"，启动失败。
- 方案一（推荐）：绕过 YAML，用
os.Getenv拼接，例如app.Listen(":" + os.Getenv("PORT")) - 方案二：用
gopkg.in/yaml.v3先读到map[string]interface{}，再调用os.ExpandEnv替换后反序列化为iris.Configuration - 方案三：放弃 YAML，直接用
os.Getenv构建配置——知识库指出它比解析 YAML 快一个数量级
别把业务配置和框架配置混在同一个 YAML 文件里
iris.YAML 只控制 iris.Application 初始化行为，比如日志开关、时间格式、错误页模板、路由修正等；它不负责数据库连接串、Redis 地址、第三方 API Key 等业务参数。
- 真正容易被忽略的是：这些业务参数应单独管理，用独立的结构体 + 自定义解析逻辑（如 JSON/TOML/etcd/consul）
- 混用会导致职责不清、测试困难、环境切换出错，也违背 Iris 设计初衷
- 若硬要统一入口，建议用 Go 代码组合：框架配置走
iris.YAML，业务配置走json.Unmarshal或viper.ReadInConfig()，最后合并传给app.Configure
