ini.load() 返回 nil 或 panic 的根本原因是路径错误、utf-8 bom 未清除、节名含非法字符（如冒号、短横线）、key 名为空或前导空格，以及未检查 err 导致后续调用 panic。
ini.Load() 返回 nil 或 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")。
UTF-8 BOM 会导致解析失败，但 ini.Load() 不自动 strip。读取前手动处理：data, _ := os.ReadFile(path); data = bytes.TrimPrefix(data, []byte("\xef\xbb\xbf"))，再用 ini.LoadSources() 加载字节流。
节名只允许字母、数字、下划线、点号和空格（goini 支持空格，go-ini/v1 默认不支持）；[db.port] 合法，[db:port] 或 [db-port] 会报错。key 名不能以空格开头，也不能为空。
务必检查 err：一旦 err != nil，返回的 cfg 是 nil，后续任何 .Section() 都 panic。
Section("xxx") 直接 panic 怎么办
默认 strict mode 下，cfg.Section("db") 找不到节就 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() 等，并传合理默认值。
结构体绑定后字段全是零值
不是 tag 写错了，就是字段没导出或大小写策略不匹配。结构体绑定（cfg.MapTo(&v)）隐式行为太多，调试困难，不如显式取值可控。
结构体字段必须首字母大写（即导出），否则反射无法访问；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。
写入并发不安全，SaveTo() 是唯一可靠方式
INI 文件没有原子写入机制。直接 f, _ := os.OpenFile(); ini.Load(f) 再 f.Write() 会导致内容错乱，尤其多 goroutine 场景下极易覆盖。
正确做法是读写分离：ini.Load("config.ini") 读，修改后调用 cfg.SaveTo("config.ini") 全量重写——这是唯一可靠方式。
如果多个地方可能并发写，用 sync.RWMutex 包住 SaveTo 调用；读操作用 RLock 即可。
禁止手动拼接字符串写入：不要用 fmt.Fprintf 拼 section 和 key。Section.Key.SetValue() 会自动处理等号前后空格、引号包裹逻辑，也保留原有注释位置。
插值语法 %(host)s 默认关闭，启用需加 AllowPythonInterpolation: true 和 Insensitive: true（否则大小写不匹配导致插值失败）；且只支持同节或 [DEFAULT] 节里的 key，跨节引用不工作。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
