Golang读写INI配置文件解析插件库ini的使用

INI文件是一种常见的配置文件格式，Go语言中可以使用go-ini/ini库来方便地读写INI格式的配置文件。下面详细介绍这个库的使用方法。

安装

首先需要安装go-ini/ini库：

go get gopkg.in/ini.v1

基本用法

1. 加载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())
}

2. 读取配置值

// 获取字符串值
name := cfg.Section("").Key("app_name").String()

// 获取整型值(带默认值)
port := cfg.Section("server").Key("port").MustInt(8080)

// 获取布尔值
debug := cfg.Section("").Key("debug").MustBool(false)

// 获取浮点数
ratio := cfg.Section("metrics").Key("ratio").MustFloat64(1.0)

3. 写入INI文件

cfg := ini.Empty()

// 设置默认分区的值
cfg.Section("").Key("app_name").SetValue("Awesome App")
cfg.Section("").Key("debug").SetValue("true")

// 添加新分区和键值
cfg.Section("server").Key("host").SetValue("localhost")
cfg.Section("server").Key("port").SetValue("8080")

// 保存到文件
err := cfg.SaveTo("my.ini")
if err != nil {
	fmt.Printf("Fail to save file: %v", err)
}

高级特性

1. 自动类型转换

// 自动类型转换
port := cfg.Section("server").Key("port").Value() // 返回字符串
portInt := cfg.Section("server").Key("port").MustInt() // 返回整数

2. 多级键名

// 支持多级键名(使用`.`分隔)
cfg.Section("paths").Key("data.dir").SetValue("/var/data")

3. 注释处理

// 读取注释
section := cfg.Section("server")
fmt.Println(section.Comment) // 获取分区注释

// 添加注释
section.Comment = "Server configuration"
key := section.Key("port")
key.Comment = "Port number to listen on"

4. 结构体映射

可以将INI文件映射到结构体：

type Config struct {
	AppName string `ini:"app_name"`
	Debug   bool   `ini:"debug"`
	Server  struct {
		Host string `ini:"host"`
		Port int    `ini:"port"`
	} `ini:"server"`
}

func main() {
	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)
}

5. 从结构体生成INI

config := Config{
	AppName: "Awesome App",
	Debug:   true,
	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("generated.ini")
if err != nil {
	fmt.Printf("Fail to save file: %v", err)
}

完整示例

package main

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

func main() {
	// 加载INI文件
	cfg, err := ini.Load("config.ini")
	if err != nil {
		log.Fatalf("Fail to read file: %v", err)
	}

	// 读取配置
	appName := cfg.Section("").Key("app_name").String()
	debug := cfg.Section("").Key("debug").MustBool(false)
	port := cfg.Section("server").Key("port").MustInt(8080)
	host := cfg.Section("server").Key("host").MustString("localhost")

	fmt.Printf("App Name: %s\n", appName)
	fmt.Printf("Debug Mode: %v\n", debug)
	fmt.Printf("Server: %s:%d\n", host, port)

	// 修改配置
	cfg.Section("").Key("app_name").SetValue("New App Name")
	cfg.Section("server").Key("port").SetValue("9090")

	// 添加新配置项
	cfg.Section("database").Key("host").SetValue("db.example.com")
	cfg.Section("database").Key("user").SetValue("admin")
	cfg.Section("database").Key("password").SetValue("secret")

	// 保存配置
	err = cfg.SaveTo("config_modified.ini")
	if err != nil {
		log.Fatalf("Fail to save file: %v", err)
	}
	fmt.Println("Config file saved successfully")
}

注意事项

1. 键名大小写不敏感，默认会转换为小写
2. 可以使用cfg.BlockMode = false禁用并发安全模式提高性能
3. 支持从[]byte或io.Reader加载配置
4. 支持递归读取分区，如[parent.child]

go-ini/ini库功能强大且易于使用，是处理INI配置文件的优秀选择。