最稳方案是固定用gopkg.in/ini.v1；读取失败或panic主因是路径、BOM、节名非法或未检查err，而非配置内容本身。
最稳的方案是固定用 gopkg.in/ini.v1，别碰 github.com/go-ini/ini/v2 或旧分支；读取失败或 panic 的根源几乎全是路径、BOM、节名合法性或没检查 err，跟配置内容本身关系不大。
加载时文件打不开或解析 panic 怎么办
错误信息像 open config.ini: no such file or directory 或 line 5: invalid section name "db:port"，不是配置写错了，而是加载环节崩在了底层细节上：
- 路径必须绝对：直接传
"config.ini"会按os.Getwd()解析，线上启动目录常和二进制不在一起；改用filepath.Join(filepath.Dir(os.Args[0]), "config.ini") - BOM 必须手动清除：UTF-8 文件带 BOM 会导致解析失败；读取后先
bytes.TrimPrefix(data, []byte("\xef\xbb\xbf"))，再用ini.LoadSources()加载字节流 - 节名只允许字母、数字、下划线、点号和空格；
[db.port]合法，[db:port]、[db-port]都会报错 - key 名不能为空或以空格开头；否则报
invalid key name "" -
err != nil时cfg是nil，后续任何.Section()都 panic —— 必须先判错再用
Section("xxx") 直接 panic 怎么避免
cfg.Section("db") 在默认 strict 模式下找不到节就 panic，它不是“获取或创建”，只是“获取”。别指望自动 fallback：
- 全局容错：加载时加
ini.LoadOptions{Loose: true}，让不存在的节返回空节而非 panic - 局部容错：链式调用更安全，例如
cfg.Section("log").Key("level").MustString("info")—— 即使节不存在，Section()返回空节，Key()返回空 key，MustString()仍能兜底 - 显式判断：用
cfg.HasSection("db")先确认存在性，再操作 - 注意：
.String()和.Int()不带默认值，key 不存在或类型转换失败时返回零值（""、0、false），极易静默出错；一律优先用MustString()、MustInt()等，并传合理默认值
写入配置时怎么不丢格式、不覆盖错
cfg.SaveTo("config.ini") 是覆盖式写入，不支持原子写、不保留原始换行风格，也无并发保护：
立即学习“go语言免费学习笔记（深入）”；
- 想保留注释和空行？必须用
ini.Load("config.ini")读取后再改再保存；用ini.Empty()是从零构建，生成的文件干净但无格式保留 - 多 goroutine 写同一文件？必须加
sync.RWMutex包住SaveTo()调用；读操作可用RLock，写操作用Lock - 中文 value 出现
???？根本原因是文件保存为 GBK/GB2312，而库默认按 UTF-8 解析；确保编辑器存为 UTF-8 无 BOM - 禁止手动拼字符串写入：不要用
fmt.Fprintf拼 section 和 key；Section.Key.SetValue()会自动处理等号前后空格、引号包裹逻辑
真正容易被忽略的是：插值（如 %(host)s）默认关闭，跨节引用不工作，且大小写敏感策略必须显式开启；还有结构体绑定时字段未导出、tag 大小写不匹配、嵌套结构体不被识别——这些都不是配置问题，而是反射层面的隐式约束。每一步都得亲手验证，不能靠“应该能行”蒙混过关。
