Go语言解析含表名的TOML文件失败，求解决方案

你遇到的问题核心是结构体和TOML结构不匹配，加上Go语言的字段可见性规则导致的，下面给你两种可行的解决方法：

方法一：用结构体匹配单个表 #

当TOML里只有[kiwi]这一个表时，需要定义包含导出字段的顶层结构体，字段对应表名：

package main

import (
	"fmt"
	"github.com/BurntSushi/toml"
)

type (
	// 定义水果属性的结构体，字段正常导出
	fruitSpecs struct {
		Id   int    `toml:"id"`
		Name string `toml:"name"`
	}
	// 顶层结构体，包含对应TOML表的导出字段
	fruits struct {
		Kiwi fruitSpecs `toml:"kiwi"` // 首字母大写导出，toml标签对应表名
	}
)

func main() {
	blob := `
[kiwi]
    id = 1234581941
    name = "kiwi"
`
	o := &fruits{}
	err := toml.Unmarshal([]byte(blob), o)
	if err != nil {
		fmt.Println("解析失败:", err)
		return
	}
	fmt.Println(o.Kiwi.Id) // 输出 1234581941
}

关键注意点： #

• Go里只有首字母大写的字段是导出的，toml库依赖反射访问字段，所以必须导出字段；你第二次尝试里的fruit字段是小写，属于私有字段，库根本读不到。
• 结构体字段的toml标签要和TOML里的表名完全一致（比如toml:"kiwi"对应[kiwi]）。

方法二：用Map接收多个同类型表 #

如果TOML里可能有多个水果表（比如[kiwi]、[apple]），用map[string]fruitSpecs接收更灵活，不需要提前定义每个表的字段：

package main

import (
	"fmt"
	"github.com/BurntSushi/toml"
)

type fruitSpecs struct {
	Id   int    `toml:"id"`
	Name string `toml:"name"`
}

func main() {
	blob := `
[kiwi]
    id = 1234581941
    name = "kiwi"

[apple]
    id = 67890
    name = "apple"
`
	var fruits map[string]fruitSpecs
	err := toml.Unmarshal([]byte(blob), &fruits)
	if err != nil {
		fmt.Println("解析失败:", err)
		return
	}
	fmt.Println(fruits["kiwi"].Id)  // 输出 1234581941
	fmt.Println(fruits["apple"].Id) // 输出 67890
}

为什么你之前的代码不行？ #

1. 第一次尝试：直接用fruitSpecs解析带[kiwi]的TOML，相当于告诉库要解析平级的id和name键，但这两个键在[kiwi]表下面，所以匹配不上，解析后字段都是零值。
2. 第二次尝试：虽然定义了fruits结构体，但依然用&fruitSpecs{}去解析，根本没用到fruits；而且fruits里的fruit字段是小写私有字段，就算用fruits解析，库也访问不到。

内容的提问来源于stack exchange，提问作者Gonzalo