Go语言如何将struct转换为字段点路径组成的扁平字符串切片

最优实现思路 #

因为待转换的结构体结构在编译期完全已知，核心思路是完全放弃反射方案，用静态预定义+动态部分低开销拼接，完全规避运行时的类型解析开销，性能可以达到最优。

具体实现逻辑 #

• 固定路径预定义：所有不存在动态变化的字段路径直接写死为预初始化的切片元素，运行时不需要任何计算直接复用。比如示例中的Example.Foo、Example.Baz.A这类静态嵌套字段路径，不需要做任何运行时拼接。
• 预分配结果内存：提前计算结果切片的总长度（静态路径固定长度 + 运行时动态部分的长度），初始化时直接分配刚好足够的容量，完全避免append过程中的内存扩容和拷贝开销。
• 动态部分低开销拼接：对于切片这类需要拼接动态索引的部分，提前写死固定前缀，用字节切片配合strconv.AppendInt这类底层方法完成拼接，相比fmt.Sprintf或者字符串+拼接可以减少大量额外的内存分配和类型转换开销。

示例代码 #

package main

import "strconv"

type Example struct {
	Foo string
	Bar string
	Baz struct {
		A int
		B string
	}
	Qux []string
}

// 预定义所有静态路径
var staticPaths = []string{
	"Example.Foo",
	"Example.Bar",
	"Example.Baz.A",
	"Example.Baz.B",
}

// 预定义动态部分的固定前缀
const quxPathPrefix = "Example.Qux."

func GetExampleFieldPaths(e Example) []string {
	// 预分配完全匹配的容量，避免扩容
	res := make([]string, 0, len(staticPaths)+len(e.Qux))
	// 直接追加静态路径，零计算开销
	res = append(res, staticPaths...)
	// 处理动态切片部分
	buf := make([]byte, 0, len(quxPathPrefix)+10) // 10位足够存int类型的最大长度
	for i := range e.Qux {
		buf = buf[:0]
		buf = append(buf, quxPathPrefix...)
		buf = strconv.AppendInt(buf, int64(i), 10)
		res = append(res, string(buf))
	}
	return res
}

如果后续结构体结构有调整，只需要同步更新预定义的静态路径即可，可以补充单元测试校验生成结果和预期一致，避免结构修改后漏更逻辑。

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