golang的反射机制可用于结构体字段遍历和json序列化。1. 使用reflect.typeof()获取结构体类型并遍历字段以读取字段名、类型和标签;2. 通过reflect.valueof()获取字段值,并用iszero()判断是否为空以决定是否输出;3. 构建map[string]interface{},根据字段名、值和标签组装键值对,最终调用json.marshal()生成json数据;4. 注意事项包括字段导出规则、标签解析、性能优化及匿名字段处理。这些步骤构成了实现自定义json序列化的核心流程。

Golang 的反射机制非常强大,尤其在处理结构体字段遍历和 JSON 序列化时特别有用。如果你写过一些中间件、ORM 或者配置解析的代码,就会发现反射几乎是绕不开的一环。

要实现类似 JSON 序列化的功能,关键在于如何通过反射拿到结构体的字段信息,并根据字段类型进行相应处理。下面我们就从几个常用角度出发,看看具体怎么操作。
如何获取结构体字段信息
使用 reflect 包可以轻松获取结构体字段的信息。核心步骤是:
立即学习“go语言免费学习笔记(深入)”;

- 使用
reflect.TypeOf()获取结构体类型 - 遍历结构体字段(Field)
- 读取字段名、类型、标签等元数据
举个例子:
type User struct {
Name string `json:"name"`
Age int `json:"age,omitempty"`
}
func main() {
u := User{}
t := reflect.TypeOf(u)
for i := 0; i < t.NumField(); i++ {
field := t.Field(i)
fmt.Println("字段名:", field.Name)
fmt.Println("JSON标签:", field.Tag.Get("json"))
}
}这样就能遍历出所有字段,并提取 JSON 标签的内容。这是构建序列化逻辑的第一步。

字段值的读取与判断是否为空
光有字段类型还不够,我们还需要读取字段的值,并判断它是否为“零值”,以决定是否输出到 JSON 中(比如 omitempty)。
这里要用到 reflect.ValueOf(),然后配合 IsZero() 方法判断是否为空。
示例代码如下:
v := reflect.ValueOf(u)
for i := 0; i < v.NumField(); i++ {
val := v.Field(i)
if val.IsZero() {
continue // 跳过空值字段
}
fmt.Println("字段值:", val.Interface())
}注意:IsZero() 对结构体嵌套等情况也有效,但对指针类型可能需要额外处理(比如先用 Elem() 取值)。
构建 JSON 键值对的基本思路
有了字段名、值和标签之后,就可以开始拼装 JSON 数据了。一般做法是:
- 创建一个
map[string]interface{} - 遍历结构体字段
- 检查是否导出(字段名首字母大写)、是否为零值、是否有
json:"-"标签 - 如果符合条件,将字段值加入 map
- 最后调用
json.Marshal()输出结果
举个简化的流程:
data := make(map[string]interface{})
for i := 0; i < t.NumField(); i++ {
field := t.Field(i)
val := v.Field(i)
if !val.IsValid() || val.IsZero() {
continue
}
jsonTag := field.Tag.Get("json")
if jsonTag == "-" {
continue
}
key := jsonTag
if key == "" {
key = field.Name
}
data[key] = val.Interface()
}这段逻辑基本就是标准库 encoding/json 在做结构体序列化时的核心流程之一。
实际开发中的一些注意事项
- 私有字段不会被反射访问到:结构体字段必须首字母大写,否则无法被反射访问。
-
标签处理要灵活:有时候标签里会包含选项如
omitempty,需要用字符串分割来判断。 - 性能问题要考虑:反射本身效率较低,频繁调用时建议缓存结构体信息。
- 匿名字段也要处理:如果结构体中嵌套了其他结构体,记得递归处理它们。
基本上就这些内容。掌握了结构体字段遍历和反射的基本操作,你就能写出一个简单的 JSON 编码器了。虽然比不上标准库完整,但在某些特定场景下还是挺实用的。










