Go INI 读取不存在的键与 MustString 默认值有什么区别

在 Go INI 中，Section.Key("name") 和 Section.GetKey("name") 解决的是“要不要保留缺失错误”，而 MustString("默认值") 解决的是“空值时要不要兜底”。它们不是两个等价的默认值写法。

官方地址：https://github.com/go-ini/ini

最容易记住的结论是：允许配置缺省时用 Key(...).MustString(...)；必须确认配置存在时用 GetKey(...) 检查错误；如果还要区分“键不存在”和“键存在但值为空”，就不要只看 MustString 的结果。

先区分 Key 与 GetKey 的读取语义

GetKey 返回 (*Key, error)。键不存在时，它会返回错误，适合端口、数据源地址这类缺失就不能继续启动的配置。Key 只返回 *Key；官方文档把它定义为“假定键存在”，不存在时创建一个值为空的键，因此调用方看不到缺失错误。

section := cfg.Section("server")

// GetKey 保留“键不存在”这个错误事实，适合必填配置。
portKey, err := section.GetKey("port")
if err != nil {
    return fmt.Errorf("读取 server.port 失败: %w", err)
}
port := portKey.String()

// Key 把不存在的键当成空值键，适合后续自行决定是否兜底。
name := section.Key("name").String()

因此，Key("name").String() 得到空字符串时，可能是键不存在，也可能是配置文件里写了 name=。这个调用本身不会告诉你是哪一种。

MustString 默认值处理的是空值

官方 API 对 MustString 的定义很直接：键值为空时返回传入的默认值。源码还会把这个默认值写回当前 Key 对象，所以同一个键对象随后再次读取时会看到兜底后的值。

// MustString 让可选配置在缺失或空值时使用稳定默认值。
timeout := section.Key("timeout").MustString("5s")
fmt.Println(timeout)

// 已有非空值不会被默认值覆盖。
mode := section.Key("mode").MustString("safe")
fmt.Println(mode)

这里有一个重要边界：MustString 判断的是最终字符串是否为空，不负责区分缺失键和显式空值。若配置是 timeout=，它同样会返回并写入 5s。若配置是 timeout=0s，字符串并不为空，结果仍是 0s，不会因为看起来像“零值”而自动替换。

三种配置场景该怎么选

如果业务把空字符串当成“关闭功能”，就不要直接使用 MustString，否则显式关闭可能被默认值重新打开。反过来，如果空值没有业务含义，只是用户漏填，那么 MustString 正好把策略集中在读取处。

用最小对照代码确认结果

package main

import (
    "fmt"

    ini "gopkg.in/ini.v1"
)

func main() {
    // 这个配置同时覆盖正常值、显式空值和不存在的键。
    cfg, err := ini.Load([]byte("[server]\nmode=safe\ntimeout=\n"))
    if err != nil {
        panic(err)
    }

    server := cfg.Section("server")
    // 非空值保留原值，默认参数不会覆盖 safe。
    mode := server.Key("mode").MustString("fallback")
    // 空值会使用默认值，timeout 的显式空值与缺失键表现相同。
    timeout := server.Key("timeout").MustString("5s")
    missing := server.Key("missing").MustString("from-default")
    fmt.Println(mode, timeout, missing)

    // GetKey 单独保留缺失键错误，便于必填配置做启动检查。
    if _, err := server.GetKey("required"); err != nil {
        fmt.Println("required missing")
    }
}

这段示例的关键不是记住某个固定输出，而是观察读取策略：mode 保持原值，timeout 和 missing 都进入默认分支，而 GetKey("required") 仍然能单独报告键不存在。

常见问题

MustString 会检查配置类型是否合法吗？

不会。它只返回字符串或空值默认值；如果需要整数、时长或布尔值的解析错误，应使用对应的转换方法并处理 error，不要把字符串兜底当成类型校验。

调用 MustString 后会修改磁盘上的 INI 文件吗？

不会。默认值写回的是内存中的 Key 对象；只有显式调用保存方法时，才进入文件写回流程。

总结：GetKey 负责发现缺失，Key 负责方便地拿到一个键对象，MustString 负责对空字符串做默认处理。先决定配置缺失是否应该成为错误，再选择读取方式，代码就不会把“没写配置”和“写了空配置”混在一起。