Go语言高效解析与生成INI配置文件：go-ini库使用指南

INI文件是一种常见的配置文件格式，Go语言中go-ini库提供了高效解析和生成INI文件的功能。下面详细介绍其使用方法。

安装go-ini库

go get gopkg.in/ini.v1

基础使用

加载INI文件

package main

import (
	"fmt"
	"gopkg.in/ini.v1"
)

func main() {
	cfg, err := ini.Load("my.ini")
	if err != nil {
		fmt.Printf("Fail to read file: %v", err)
		return
	}
	
	// 获取默认分区
	fmt.Println("App Name:", cfg.Section("").Key("app_name").String())
	
	// 获取指定分区
	fmt.Println("Server Port:", cfg.Section("server").Key("port").String())
}

创建并保存INI文件

func createIni() {
	cfg := ini.Empty()
	
	// 默认分区设置
	cfg.Section("").Key("app_name").SetValue("awesome_web")
	cfg.Section("").Key("log_level").SetValue("DEBUG")
	
	// 添加分区
	serverSec := cfg.Section("server")
	serverSec.Key("host").SetValue("0.0.0.0")
	serverSec.Key("port").SetValue("8080")
	
	// 保存到文件
	err := cfg.SaveTo("my.ini")
	if err != nil {
		fmt.Printf("Fail to save file: %v", err)
		return
	}
}

高级特性

1. 类型转换

func typeConversion(cfg *ini.File) {
	// 字符串
	appName := cfg.Section("").Key("app_name").String()
	
	// 整数
	port, _ := cfg.Section("server").Key("port").Int()
	
	// 布尔值
	debug, _ := cfg.Section("").Key("debug").Bool()
	
	// 浮点数
	ratio, _ := cfg.Section("metrics").Key("ratio").Float64()
	
	fmt.Printf("App: %s, Port: %d, Debug: %v, Ratio: %f\n", 
		appName, port, debug, ratio)
}

2. 自动映射到结构体

type Config struct {
	AppName  string `ini:"app_name"`
	LogLevel string `ini:"log_level"`
	
	Server struct {
		Host string `ini:"host"`
		Port int    `ini:"port"`
	} `ini:"server"`
}

func structMapping() {
	cfg, err := ini.Load("my.ini")
	if err != nil {
		fmt.Printf("Fail to read file: %v", err)
		return
	}
	
	var config Config
	err = cfg.MapTo(&config)
	if err != nil {
		fmt.Printf("Fail to map config: %v", err)
		return
	}
	
	fmt.Printf("Config: %+v\n", config)
}

3. 从结构体生成INI

func generateFromStruct() {
	config := Config{
		AppName:  "awesome_app",
		LogLevel: "INFO",
		Server: struct {
			Host string `ini:"host"`
			Port int    `ini:"port"`
		}{
			Host: "localhost",
			Port: 8080,
		},
	}
	
	cfg := ini.Empty()
	err := ini.ReflectFrom(cfg, &config)
	if err != nil {
		fmt.Printf("Fail to reflect config: %v", err)
		return
	}
	
	err = cfg.SaveTo("config.ini")
	if err != nil {
		fmt.Printf("Fail to save file: %v", err)
		return
	}
}

4. 分区和键操作

func sectionKeyOperations() {
	cfg, _ := ini.Load("my.ini")
	
	// 检查分区是否存在
	if cfg.HasSection("server") {
		fmt.Println("Server section exists")
	}
	
	// 检查键是否存在
	if cfg.Section("server").HasKey("port") {
		fmt.Println("Port key exists")
	}
	
	// 删除键
	cfg.Section("server").DeleteKey("port")
	
	// 添加新分区
	newSec, _ := cfg.NewSection("database")
	newSec.NewKey("host", "127.0.0.1")
	newSec.NewKey("port", "3306")
	
	// 保存修改
	cfg.SaveTo("my_modified.ini")
}

最佳实践

1. 错误处理：始终检查Load、Save等操作的错误
2. 默认值：使用Must系列方法提供默认值

   port := cfg.Section("server").Key("port").MustInt(8080)
   

3. 注释处理：go-ini会保留INI文件中的注释
4. 性能考虑：对于频繁读取的配置，可解析一次后缓存配置对象

完整示例

package main

import (
	"fmt"
	"gopkg.in/ini.v1"
)

func main() {
	// 创建配置
	createConfig()
	
	// 读取配置
	readConfig()
}

func createConfig() {
	cfg := ini.Empty()
	
	// 默认分区
	cfg.Section("").Key("app_name").SetValue("my_app")
	cfg.Section("").Key("log_level").SetValue("info")
	
	// server分区
	server := cfg.Section("server")
	server.Key("host").SetValue("0.0.0.0")
	server.Key("port").SetValue("8080")
	server.Key("timeout").SetValue("30s")
	
	// database分区
	db := cfg.Section("database")
	db.Key("host").SetValue("localhost")
	db.Key("port").SetValue("3306")
	db.Key("user").SetValue("root")
	db.Key("password").SetValue("secret")
	
	// 保存
	err := cfg.SaveTo("config.ini")
	if err != nil {
		fmt.Printf("保存配置失败: %v\n", err)
	}
}

func readConfig() {
	cfg, err := ini.Load("config.ini")
	if err != nil {
		fmt.Printf("读取配置失败: %v\n", err)
		return
	}
	
	// 读取值
	fmt.Println("App:", cfg.Section("").Key("app_name").String())
	fmt.Println("Log Level:", cfg.Section("").Key("log_level").String())
	
	// 带默认值的读取
	fmt.Println("Server Port:", cfg.Section("server").Key("port").MustInt(8080))
	fmt.Println("DB Host:", cfg.Section("database").Key("host").MustString("127.0.0.1"))
	
	// 结构体映射
	type DatabaseConfig struct {
		Host     string `ini:"host"`
		Port     int    `ini:"port"`
		User     string `ini:"user"`
		Password string `ini:"password"`
	}
	
	var dbConfig DatabaseConfig
	err = cfg.Section("database").MapTo(&dbConfig)
	if err != nil {
		fmt.Printf("映射数据库配置失败: %v\n", err)
		return
	}
	
	fmt.Printf("Database Config: %+v\n", dbConfig)
}

go-ini库提供了丰富的功能来处理INI配置文件，包括读写、类型转换、结构体映射等，是Go语言中处理INI配置文件的优秀选择。