最稳方案是固定用gopkg.in/ini.v1；路径须绝对、需去BOM、节名禁特殊字符、务必检查err；Section()默认strict会panic，应配Loose:true或HasSection()判断；弃MapTo改显式取值；插值需AllowPythonInterpolation+Insensitive。
ini.Load() 会 panic 或返回 nil，不是配置写错了，而是路径、编码、节名合法性或模块版本用错了。最稳的方案是固定用 gopkg.in/ini.v1，不碰 github.com/go-ini/ini/v2。
加载时文件找不到或解析失败怎么办
错误信息像 open config.ini: no such file or directory 或 line 5: invalid section name "db.port"，根本原因不是配置内容错，而是加载环节没兜住。
- 路径必须是绝对路径，
ini.Load("config.ini")按os.Getwd()解析，线上启动目录常和二进制不在一起；改用filepath.Join(filepath.Dir(os.Args[0]), "config.ini") - 文件含 UTF-8 BOM 会导致解析失败，读取前先
bytes.TrimPrefix(data, []byte("\xef\xbb\xbf")) - 节名不能含点号以外的特殊字符（如
[db.port]合法，但[db:port]不合法），key 名也不能为空或以空格开头 - 必须检查
err：如果err != nil，cfg是 nil，后续任何.Section()都会 panic
section 不存在就 panic 怎么办
cfg.Section("db") 在 strict mode 下找不到节直接 panic，但它不是“获取或创建”，只是“获取”。别依赖它自动 fallback。
- 加加载选项：
ini.LoadOptions{Loose: true}，让Section()返回空节而非 panic - 用
cfg.HasSection("db")显式判断存在性，再操作 - 链式调用更安全：
cfg.Section("log").Key("level").MustString("info")—— 即使节不存在，Section()返回空节，Key()返回空 key，MustString()仍能兜底 - 注意：
.String()和.Int()不带默认值，key 不存在或类型转换失败时返回零值，极易静默出错；一律优先用MustString()、MustInt()等
结构体绑定后字段全是零值
不是 tag 写错了，就是字段没导出或大小写策略不匹配。结构体绑定（cfg.MapTo(&v)）隐式行为太多，调试困难，不如显式取值可控。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 结构体字段必须首字母大写（即导出），否则反射无法访问
- tag 中的节名和 key 名要严格匹配配置里的大小写，除非加载时传
ini.LoadOptions{Insensitive: true} - 嵌套结构体不被自动识别，
type Config struct { DB DBConfig `ini:"database"` }中DBConfig字段不会自动映射到[database]下的 key - 建议放弃
MapTo，改用cfg.Section("server").Key("port").MustInt(8080)这类写法，每一步都可 debug、可加日志、可 fallback
插值语法 %(host)s 不生效
Go-INI 默认关闭插值，且只支持同节或 [DEFAULT] 节内引用，跨节无效。启用后还必须配对开启大小写不敏感，否则插值变量名大小写不一致就失效。
立即学习“go语言免费学习笔记（深入）”；
- 加载时必须加选项：
ini.LoadOptions{AllowPythonInterpolation: true, Insensitive: true} - 插值只认
%(key)s形式，不支持${key}（那是 shell 风格，需额外开AllowShellStyle） -
[DEFAULT]节里定义的 key 可被所有节引用，但[mysql]里定义的host无法被[redis]引用 - 若插值后值仍是原样字符串（如返回
"%(host)s:3306"），先确认是否漏了Insensitive: true—— 插值变量名大小写不一致时，Insensitive关闭就会失败
cfg.Section("").Keys() 看是否拿到顶层 key，再查节，再取值。 
