TOML 原生不支持 JSON 风格的字符串化 map，但可通过内联表（inline table）或数组式表（array of tables）自然表达键值对映射关系，Go 程序可直接解析为 map[string]string 或结构体切片。
toml 原生不支持 json 风格的字符串化 map，但可通过内联表（inline table）或数组式表（array of tables）自然表达键值对映射关系，go 程序可直接解析为 `map[string]string` 或结构体切片。
在 TOML 中，“map” 并非独立数据类型，而是通过 内联表（Inline Table） 或 数组式表（Array of Tables） 语义化建模键值对集合。直接将 JSON 字符串（如 '{"user1":"pass1"}'）存为字符串字段虽可行，但会丧失 TOML 的类型安全与解析便利性——Go 的 toml 解析器（如 BurntSushi/toml 或官方推荐的 go-toml）无法自动将其反序列化为 map[string]string，需手动 json.Unmarshal，既冗余又易错。
✅ 推荐做法：使用内联表表示单个映射，或用数组式表表示多个条目。
方式一：单个内联表（适用于固定、已知键名的轻量映射）
# config.toml
credentials = { user1 = "pass1", user2 = "pass2", admin = "s3cr3t" }
对应 Go 结构体：
type Config struct {
Credentials map[string]string `toml:"credentials"`
}
✅ 解析后 Credentials 直接为 map[string]string，无需额外处理。
方式二：数组式表（推荐用于用户列表等动态集合）
# config.toml [[users]] name = "user1" password = "pass1" [[users]] name = "user2" password = "pass2"
或更紧凑的内联写法：
users = [
{ name = "user1", password = "pass1" },
{ name = "user2", password = "pass2" }
]
对应 Go 结构体：
type User struct {
Name string `toml:"name"`
Password string `toml:"password"`
}
type Config struct {
Users []User `toml:"users"`
}
⚠️ 注意事项：
- TOML 键名区分大小写，且不允许空格或特殊字符（建议用小写字母+下划线）；
- 内联表必须写在单行内，不可换行（否则语法错误）；
- 数组式表
[[xxx]]支持重复定义，天然适配列表场景； - 若需严格映射语义（如配置中心级 key-value），也可考虑将 TOML 视为“静态配置源”，在 Go 层构建
map[string]string，例如遍历users切片并构造m[user.Name] = user.Password。
总结：抛弃 "{"key":"val"}" 字符串方案，拥抱 TOML 原生结构——它更清晰、更安全、更易维护，也让 Go 解析真正“零胶水”。
