iris框架不提供配置文件解析能力，仅接受iris.configuration结构体；真实项目应使用viper自动识别yaml/json格式、支持多路径fallback和类型转换，避免手动解析导致的类型错误或加载失败。
直接用 viper 读 YAML/JSON，别碰 Iris 自带的配置加载逻辑
Iris 框架本身不提供配置文件解析能力——它只接受一个 iris.Configuration 结构体实例。所谓“Iris 配置文件”，其实是你项目自己加载、解析、转成该结构体的过程。硬套 app.Configure(iris.WithConfiguration(...)) 或 app.Run(..., cfg) 前不做配置解析，等于把空结构体传进去，服务起不来还查不出原因。
真实项目里，95% 的配置加载都该交给 viper：它自动识别 .yaml/.yml/.json 后缀，支持多路径 fallback、环境变量注入、类型强转，且和 Iris 完全解耦。
- 别写
viper.SetConfigType("yaml")——让viper自己从文件扩展名推断格式，否则.yml文件会加载失败 -
viper.AddConfigPath("./config")和viper.AddConfigPath(".")必须同时加，避免因工作目录不同导致viper.ConfigFileNotFoundError - 调用
viper.ReadInConfig()后必须检查 error；若为viper.ConfigFileNotFoundError，可安全 fallback 到默认值，其他 error 应log.Fatal
YAML 文件里写字符串端口，Iris 启动却报 port 类型错误？
典型现象：config.yaml 里写 port: "8080"（字符串），但 iris.Configuration 中 Port 是 int 字段，启动时报错 cannot unmarshal string into Go struct field Configuration.Port of type int。
这是因为 viper.Unmarshal() 默认不做类型强转；而手写 yaml.Unmarshal() 更严格，连 "8080" → int 都拒绝。
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
- 用
viper.GetInt("port")替代直接viper.Unmarshal(&cfg)，viper会自动尝试字符串转数字 - 或在
viper初始化后加viper.SetTypeByDefaultValue(true)，让它按 struct 字段类型反推默认值行为 - 更稳妥的是：YAML 里就写
port: 8080（不加引号），避免语义歧义
为什么不能用 json.Unmarshal 解析 YAML 文件？
直接把 config.yaml 内容丢给 json.Unmarshal()，大概率触发 invalid character 'y' looking for beginning of value 或类似错误——它连文件开头的 yam 都不认识。
YAML 不是 JSON 超集。它支持注释、锚点（&default）、合并（）、类型标记（<code>!!binary）等语法，json.Unmarshal() 完全不识别。
- 必须用
gopkg.in/yaml.v3解析 YAML，用encoding/json解析 JSON - 如果非要统一入口，用
filepath.Ext(filename)判断后缀，再分发到对应Unmarshal函数 -
viper内部已封装这层判断，你不用操心
结构体字段标签写 json:"port" 还是 yaml:"port"？
两者都写没问题，但优先级有差异：gopkg.in/yaml.v3 默认先找 yaml: 标签，找不到才 fallback 到 json:；encoding/json 只认 json:。
所以一个 struct 同时用于 YAML 和 JSON 配置是可行的，前提是字段名一致、嵌套结构一致。
- 推荐只写
yaml:"port"，因为 YAML 更常用、表达力更强；JSON 场景下viper仍能正确映射 - 避免显式写两个且值不同，比如
json:"user_id" yaml:"uid"——会导致两种格式绑定到不同字段，调试时极难发现 - 字段必须是导出的（首字母大写），否则
viper.Unmarshal()或yaml.Unmarshal()都无法赋值
viper 对 !!null、&anchor、路径不存在、权限不足、类型错配这些细节的内置处理。别省那几行代码。
