如何使用Golang读取INI配置文件_Golang gopkg ini配置解析示例_技术教程

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：

[database]
host = localhost
port = 5432
ssl = false

[cache]
ttl = 300
enabled = true

对应读取代码：

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]) 拼接