最稳的是 github.com/go-ini/ini@v1.67.0，需禁用 strict mode、启用 allowpythoninterpolation、确保结构体字段首字母大写且 tag 匹配，避免 v2 不兼容问题。
Go 读 ini 文件用哪个库最稳
别碰 goini 和 go-ini/ini 的旧分支，现在主流且维护活跃的是 github.com/go-ini/ini（v1.67+），它支持大小写敏感、注释、嵌套节、环境变量替换，而且没 runtime panic 风险。
常见错误是直接 go get github.com/go-ini/ini 不加版本，结果拉到 v2+ 的模块路径变更版（github.com/go-ini/ini/v2），但 v2 是实验性重构，API 不兼容、文档缺失、issue 基本没人回。坚持用 v1。
- 安装命令必须写成：
go get github.com/go-ini/ini@v1.67.0 - 导入时写：
import "github.com/go-ini/ini"（不是v2） - 如果项目已用 v2 并报
undefined: ini.Load，说明函数签名变了——退回来，别硬扛
读取时 panic: "section not found" 怎么办
这不是配置文件写错了，而是默认开启了 strict mode：只要 cfg.Section("db") 找不到节名，就 panic。而很多人以为 Section() 是“获取或创建”，其实它只是“获取”，不存在就崩。
正确做法是先用 cfg.HasSection("db") 判断，或者改用更安全的 cfg.Section("db").HasKey("host") 这类链式调用——它们内部会自动创建空节，不 panic。
- 想全局禁 strict：加载时加选项
ini.LoadOptions{Loose: true} - 想局部容错：用
cfg.Section("log").Key("level").MustString("info")，而不是.String() - 注意
MustString()的默认值只在 key 不存在时生效；如果 key 存在但值为空字符串，它仍返回空串，不会 fallback
ini 中的变量引用（比如 %(host)s）能用吗
能，但默认关闭。Go-INI 支持类似 Python ConfigParser 的插值语法，例如：
[common] host = 127.0.0.1 [mysql] server = %(host)s:3306
但必须显式启用插值，否则 cfg.Section("mysql").Key("server").String() 返回原样 "%(host)s:3306"。
- 加载时加选项：
ini.LoadOptions{Insensitive: true, AllowShadows: true, InsensitiveSections: true, AllowPythonStyleComments: true, SkipUnrecognizedLines: true, EnableCaseSensitive: false, AllowNestedValues: false, AllowPythonInterpolation: true} - 实际只需关注两个关键项：
AllowPythonInterpolation: true和Insensitive: true（否则大小写不匹配会导致插值失败） - 插值只支持同节或
[DEFAULT]节里的 key，跨节引用不工作
结构体绑定后字段一直是零值
不是 struct tag 写错了，就是字段没导出。Go-INI 的 cfg.MapTo(&conf) 或 cfg.ReflectFrom(&conf) 依赖字段首字母大写 + 正确 tag，且不处理嵌套结构体自动展开。
典型翻车点：写了 Host string `ini:"host"` 却忘了 Host 是大写——小写字段无法被反射访问，绑定后永远是空字符串或 0。
- 字段必须首字母大写（即 exported）
- tag 值区分大小写：
`ini:"HOST"`对应 ini 里HOST = ...，若 ini 是host = ...，tag 就得写`ini:"host"` - 嵌套结构体要手动分节绑定，比如
type DB struct { Host string }对应[db] host = ...，不能靠db.host自动映射 - 数组/切片不支持自动解析，
ports = 8080,8081得自己strings.Split(cfg.Section("s").Key("ports").String(), ",")
ini 解析真正的麻烦不在读，而在默认行为太“严格”——节不存在、key 不存在、字段不可见、插值未启用，全都会静默失败或 panic。盯住那几个布尔选项和首字母，比背 API 重要得多。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
