Go 语言需用 gopkg.in/ini.v1 库解析 INI 文件，支持节、键值、注释、类型转换等，但不支持嵌套节或数组；导入必须用完整路径，注意 BOM、空格、路径及 reload 行为。
Go 语言本身不内置 INI 解析器，gopkg.in/ini.v1 是最常用、稳定且符合 INI 语义的第三方库。它支持节（section）、键值对、注释、内联注释、值转义、自动类型转换等，但默认不支持嵌套节或数组语法。
安装 gopkg.in/ini.v1 并验证导入是否成功
执行命令安装：
go get gopkg.in/ini.v1
在代码中导入时必须用完整路径 "gopkg.in/ini.v1"，不能写成 "github.com/go-ini/ini"（那是旧版仓库，v1 分支已迁移至 gopkg.in）；若 import 后报错 cannot find package "gopkg.in/ini.v1"，说明 Go 模块未启用或 GOPROXY 不兼容 —— 建议确认 GO111MODULE=on，并设置可信代理如 export GOPROXY=https://goproxy.cn,direct。
基础读取：Load + Section + Key.String() 最简流程
INI 文件如 config.ini：
立即学习“go语言免费学习笔记（深入）”；
[database] host = localhost port = 5432 ssl = false [cache] ttl = 300 enabled = true
对应读取代码：
windows-shell-syntax
下载
在 Windows 上执行终端命令，或对比 Windows 与 Linux 的 Shell 语法时使用。建议先检测当前 Shell 是 PowerShell 还是 cmd.exe，再给出相应命令……
cfg, err := ini.Load("config.ini")
if err != nil {
log.Fatal(err)
}
db := cfg.Section("database")
fmt.Println(db.Key("host").String()) // 输出: localhost
fmt.Println(db.Key("port").MustInt(0)) // 输出: 5432，失败时返回默认值 0
fmt.Println(cfg.Section("cache").Key("enabled").MustBool(false)) // true
注意点：
-
Key()返回*Key，必须调用.String()/.MustInt()等方法取值，直接打印是结构体地址 - 若节或键不存在，
Key()不报错，但后续取值会返回零值或 panic（如.Int()在非数字时 panic），推荐统一用MustXXX()方法并传入默认值 -
Section()对不存在的节会自动创建空节，不是错误 —— 所以务必先用cfg.HasSection("xxx")或检查Key().Valid()再取值
结构体绑定：MapTo 要求字段名与 key 名严格匹配
定义结构体时，字段名需与 INI 中 key 名一致（忽略大小写），且必须导出（首字母大写）：
type DatabaseConfig struct {
Host string `ini:"host"`
Port int `ini:"port"`
SSL bool `ini:"ssl"`
}
var dbCfg DatabaseConfig
err := cfg.Section("database").MapTo(&dbCfg)
关键限制：
- 不支持嵌套结构体映射（如
[db.postgres]无法映射到DB PostgresConfig） - 标签
ini:"xxx"可覆盖字段名，但若省略，会按字段名小写匹配（Host→host），而SSL→ssl是 OK 的，IsSSL→isssl就不匹配了 - 若 INI 中值类型与字段类型不兼容（如把
port = abc绑定到int），MapTo返回 error，需显式检查
常见坑：空格、BOM、路径和 reload 行为
这些细节极易导致读取失败但无明确报错：
- Windows 编辑器保存的 INI 若含 UTF-8 BOM，
ini.Load()会静默失败（解析出空配置），用file.Read()先检查前3字节是否为0xEF 0xBB 0xBF，或用ini.LoadSources(ini.LoadOptions{Loose: true}, []byte(...))手动加载去 BOM 后的内容 - key 值前后有空格（如
host = localhost）默认会被 trim，但若想保留，需启用Insensitive & Loose模式：ini.LoadOptions{Insensitive: true, Loose: true} -
ini.File不支持热重载 —— 调用cfg.Reload()会重新读磁盘，但原*ini.File实例不会自动更新引用，需重新Load并替换变量 - 相对路径如
ini.Load("conf/app.ini")是相对于当前工作目录（os.Getwd()），不是二进制所在目录，生产环境建议用filepath.Dir(os.Args[0])拼接
真正麻烦的从来不是语法，而是 INI 文件里那些看不见的空格、编码、路径上下文 —— 加载前先 cat -A config.ini 看控制符，比反复改代码更省时间。
