配置文件格式 INI 快速上手

大家好，欢迎来到IT知识分享网。

文章目录

1.简介
2.语法
3.示例
4.解析
参考文献

1.简介

INI 的全称是 Initialization，即初始化，最早是 Windows 系统配置文件所采用的格式。

有时候，INI 文件也会以不同的扩展名出现，如 .cfg、.conf、或 .txt。但为了可读性，不建议这么做。

因为 INI 并没有一个统一的官方标准，所以这里介绍常见的 INI 文件格式惯例。

2.语法

INI 是一种简单实用且应用广泛的配置文件格式，通常由节、键值对和注释组成。

节

节（Section）是键值对的分组。

一般情况下，节是可选的，不属于任何节的配置项属于全局配置项。

所有的 Section 名称都是独占一行，并且 Section 名字都被方括号 [] 包围。在 Section 声明后的所有键值对都属于该 Section。一个 Section 没有明显的结束标识符，一个 Section 的开始就是上一个 Section 的结束。

[section]

注意，同一个节中不能存在同名的键，但是在不同节中可以存在同名的键。

正因为没有显式的“节结束符”（例如 XML 的</tag>）。因此，节在语法上不能任意嵌套。必要时，可以将层次结构扁平化，使用分隔符分隔多个节名（通常使用点 . 分隔）来实现嵌套。一级嵌套通常是支持的，称为子节。

[section] domain = example.com [section.subsection] foo = bar

键值对

每一个键值对表示一项配置，键与值使用等号分隔。

name=value

注释

注释以分号（;）开头，有一些 INI 管理器也支持使用井号（#）来注释。

; this is comment text

大小写

Windows 中的节和键名是不区分大小写的。大多数 Unix 风格的 INI 解析器也完全不区分大小写。

尽管部分 INI 解析器是支持大小写的，但为了良好的可读性，不建议这么做。

空白行

空白行通常被忽略，可以用来提高可读性。

数据类型

INI 文件格式的设计非常简单，不像 YAML、TOML 等更现代的配置文件格式那样明确支持多种数据类型。通常，INI 文件中的所有数据都是以字符串的形式存储的。然而，不同的解析器可能会尝试根据内容自动识别并转换数据类型。

字符串 (String)

默认情况下，所有值都被视为字符串。字符串值可以包含任何字符。

字符串值通常不需要引号，但在某些情况下可以使用引号（单引号或双引号）括起来。

key1=value1 key2=some text with spaces key3="quoted string"

整数 (Integer)

一些解析器会尝试将纯数字的值解析为整数。

key1=42 key2=-3

浮点数 (Float)

类似地，包含小数点的数字可能会被解析为浮点数。

[Section] key1=3.14 key2=-0.001

布尔值 (Boolean)

常见的布尔值表示法包括 true, false, yes, no, 1, 和 0。许多解析器会自动将这些值转换为布尔类型。

key1=true key2=no key3=1 key4=0

列表 (List)

虽然 INI 文件格式本身不直接支持列表，但可以通过使用分隔符（如逗号或分号）来模拟列表。某些解析器可以将这些值分割成列表。

key1=value1,value2,value3 key2=item1;item2;item3

3.示例

由于没有官方标准，建议在使用 INI 文件时遵循你所使用的解析器的具体规范，并保持文件结构的简单和一致。

以下是一个综合示例：

; Global section settings globalKey1=value1 [Section1] # Section1 specific settings key1=value1 key2=value2 [Section2] key1=value3 # Section2 specific settings key3=value4

4.解析

下面是一个使用键值对表示的后台服务配置。

; server basic conf [server] name=UserProfileServer maxconns=10000 queuecap=10000 queuetimeout=300 # log conf [log] loglevel=ERROR logsize=10M lognum=10 logpath=/usr/local/app/log

在解析上面的配置时，可以按行读取，然后放到 map 中。

下面以 Go 为例，完成对上面配置文件的解析。

package main import ( "bufio" "errors" "fmt" "io" "os" "strings" ) func ParseConf(confPath string) (map[string]string, error) { 
    if confPath == "" { 
    return nil, errors.New("param is ill") } f, err := os.Open(confPath) if err != nil { 
    return nil, err } defer f.Close() // store config info m := make(map[string]string) bfRd := bufio.NewReader(f) // read by line, the line terminator is '\n' for { 
    line, err := bfRd.ReadString('\n') if err == io.EOF { 
    return m, nil } if err != nil { 
    return nil, err } // ignore blank line if strings.TrimSpace(line) == "" { 
    continue } // ignore comment line if strings.TrimSpace(line)[0] == ';' || strings.TrimSpace(line)[0] == '#' { 
    continue } // ignore section line if strings.TrimSpace(line)[0] == '[' { 
    continue } kv := strings.Split(strings.TrimSpace(line), "=") if len(kv) == 2 { 
    m[kv[0]] = kv[1] } } } func main() { 
    conf, _ := ParseConf("server.ini") for k, v := range conf { 
    fmt.Printf("%v=%v\n", k, v) } }

运行结果：

name=UserProfileServer maxconns=1000 queuecap=10000 queuetimeout=300 loglevel=ERROR logsize=10M lognum=10

推荐使用专业的第三方库来完成 INI 的解析，比如 Golang 中强大的 spf13/viper。

package main import ( "fmt" "github.com/spf13/viper" ) func main() { 
    // 设置配置文件的名称和路径 viper.SetConfigName("server.ini") // 可以不写文件扩展名 viper.AddConfigPath("..") // 在当前目录查找配置文件 // 设置配置文件类型为 INI viper.SetConfigType("ini") // 读取配置文件 if err := viper.ReadInConfig(); err != nil { 
    fmt.Printf("Error reading config file, %s", err) return } // 获取配置项的值 fmt.Println("server.name:", viper.GetString("server.name")) fmt.Println("server.maxconns:", viper.GetInt("server.maxconns")) fmt.Println("server.queuecap:", viper.GetInt("server.queuecap")) fmt.Println("server.queuetimeout:", viper.GetInt("server.queuetimeout")) fmt.Println("log.loglevel:", viper.GetString("log.loglevel")) fmt.Println("log.logsize:", viper.GetString("log.logsize")) fmt.Println("log.lognum:", viper.GetInt("log.lognum")) fmt.Println("log.logpath:", viper.GetString("log.logpath")) }