beego.appconfig.string() 读不到自定义配置项，主要因配置未加载或作用域错误：必须确保 conf/app.conf 路径正确、在 beego.run() 前调用、key 名匹配（如 section::key）、runmode 设置正确且大小写一致，且非 ini 格式需手动注册解析器。
beego.AppConfig.String() 读不到自定义配置项？检查配置加载时机和作用域
Beego 默认只加载 conf/app.conf，且必须在 beego.Run() 之前完成初始化。如果在 init() 或控制器里直接调用 AppConfig.String("xxx") 却返回空，大概率是配置还没加载，或者 key 写错了。
常见错误现象：AppConfig.String("mysqluser") 返回空字符串，但配置文件里明明写了 mysqluser = root。
- 确认配置文件路径是否为项目根目录下的
conf/app.conf（不是config/app.ini或其他位置） - 确保没在
main.go中提前调用AppConfig—— 必须等beego.LoadAppConfig()或beego.Run()执行后才可用 - INI 格式不支持嵌套 section 的“点号”写法，比如
[database] user=root要用AppConfig.String("database::user")，不能写成"database.user" - 若用
beego.BConfig修改了配置加载路径（如BConfig.ConfigPath = "custom/app.ini"），需同步确保该路径存在且可读
runmode=dev 时为什么还是读不到 [dev] 下的配置？
Beego 的多环境配置依赖两个前提：一是 runmode 必须在全局 section（即无中括号）中明确定义；二是子 section 名必须与 runmode 值完全一致，区分大小写。
错误示例：runmode = DEV 但写了 [dev] section → 不会命中。
-
runmode值必须小写（dev/prod/test），否则 Beego 不识别 - 子 section 名必须严格匹配，比如
[prod]里配了httpport = 80，只有runmode = prod时才会覆盖默认httpport - 读取跨 mode 配置要用双冒号语法：
AppConfig.String("prod::mysqlhost")，但注意这不触发自动 fallback，必须存在对应 section - 环境变量优先级高于配置文件 —— 若设置了
BEEDGO_RUNMODE=prod，它会覆盖app.conf中的runmode
想用 JSON/YAML 替代 INI？别直接替换，得显式注册解析器
Beego v2 默认只内置 INI 解析器。即使你把 app.conf 改成 app.json，不改代码照样按 INI 解析，结果就是报错或读空。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
正确做法是手动初始化非 INI 配置源，并赋给 beego.AppConfig：
import (
"github.com/beego/beego/v2/core/config"
)
// 在 main.go init 或 main 开头执行
jsonConf, err := config.NewConfig("json", "conf/app.json")
if err != nil {
panic(err)
}
beego.AppConfig = jsonConf
- 支持格式：仅
"ini"、"json"、"yaml"、"xml"（注意不是yml） - JSON 不支持 section 概念，所以
AppConfig.String("dev::httpport")会失败 —— 改用扁平 key，如{"httpport": 8080, "db_host": "127.0.0.1"} - YAML 同样不支持 section，且缩进必须用空格（不能用 tab），否则解析失败静默忽略
- 一旦手动赋值
beego.AppConfig，默认的conf/app.conf就不再自动加载，全靠你自己管
多个配置文件怎么 include？INI 的 include 不是万能的
INI 格式支持 include 指令，但 Beego 的 LoadAppConfig() 默认不启用该功能 —— 它只读主文件，include 行被当注释忽略。
想真正生效，必须用 ini 库手动解析并合并：
cfg, err := ini.Load("conf/app.conf", "conf/database.conf")
if err != nil {
panic(err)
}
beego.AppConfig = &config.IniConfigContainer{Cfg: cfg}
-
include只在原生gopkg.in/ini.v1解析时有效，Beego 自己的AppConfig不处理它 - 手动 load 多个文件时，后加载的会覆盖前面同名 key（顺序很重要）
- 不要试图在
app.conf里写include "secret.conf"然后指望 Beego 自动读 —— 它不会读，更不会做权限隔离 - 敏感配置（如密码）建议通过环境变量注入，而不是塞进某个 .conf 文件再 include
最易被忽略的一点：Beego v2 的 AppConfig 是一个接口，不同解析器返回的底层实现不同。一旦你用 config.NewConfig() 替换过它，后续所有 AppConfig.String() 调用都走新实例 —— 如果新实例没加载完整配置，整个应用就可能因空值 panic。务必在 beego.Run() 前完成全部配置组装和赋值。
