如何在BurntSushi的Go TOML解析器中识别哈希表内未解码键？

使用BurntSushi的Go TOML解析器时，尝试通过MetaData.Undecoded()方法识别TOML配置中未被解码的多余键，但无法正确检测[kiwi]区块内意外添加的多余键。原代码执行后，实际输出包含多个无关键，而非仅期望的kiwi.key2。

原问题代码 #

package main

import (
	"fmt"
	"log"

	"github.com/BurntSushi/toml"
)

var blob = `
    [kiwi]
        key1 = "value1"
        key2 = "value2"
        key3 = "value3"
    `

var conf struct {
	Key1 string
	Key3 string
}

func main() {
	md, err := toml.Decode(blob, &conf)
	if err != nil {
		log.Fatal(err)
	}

	fmt.Printf("Undecoded keys: %q\n", md.Undecoded())

	// Desired output
	// Undecoded keys: ["kiwi.key2"]

	// Actual output
	// Undecoded keys: ["kiwi" "kiwi.key1" "kiwi.key2" "kiwi.key3"]
}

问题原因 #

原结构体没有正确映射TOML中的[kiwi]区块，解析器无法将区块内的键与结构体字段关联，因此把整个kiwi区块及其所有子键都标记为未解码内容。

正确解决方案 #

需要在结构体中定义嵌套结构体，对应TOML里的[kiwi]区块，字段名需与区块名一致（或通过toml标签指定），这样解析器才能正确关联区块内的键与结构体字段，进而准确识别未解码的多余键。

修正后的代码 #

package main

import (
	"fmt"
	"log"

	"github.com/BurntSushi/toml"
)

var blob = `
    [kiwi]
        key1 = "value1"
        key2 = "value2"
        key3 = "value3"
    `

// 定义嵌套结构体对应[kiwi]区块
var conf struct {
	Kiwi struct {
		Key1 string
		Key3 string
	}
}

func main() {
	md, err := toml.Decode(blob, &conf)
	if err != nil {
		log.Fatal(err)
	}

	fmt.Printf("Undecoded keys: %q\n", md.Undecoded())
	// 输出：Undecoded keys: ["kiwi.key2"]
}

说明 #

修正后，结构体的Kiwi字段对应TOML中的[kiwi]区块，区块内的key1和key3会被正确解码到嵌套结构体的对应字段中，而未被结构体定义的key2则会被MetaData.Undecoded()准确识别为未解码键。

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