如何在 Go 中遍历结构体时跳过空字段（nil 或零值）_技术教程

本文介绍如何使用反射机制遍历 go 结构体，仅提取具有非零、非空、非 nil 值的字段名，适用于表单处理、api 请求过滤等场景。

在 Go 中，结构体字段默认初始化为对应类型的零值（如 string 为 ""，int 为 0，指针/切片/映射为 nil）。当从用户输入（如 HTTP 表单或 JSON）构造结构体后，常需忽略未填写或未设置的字段——即跳过所有“空”字段（包括零值和 nil）。此时单纯遍历字段名是不够的，必须结合字段值进行判断。

下面是一个通用、安全的解决方案，使用 reflect 包实现：

package main

import (
    "fmt"
    "reflect"
)

type Users struct {
    Name     string
    Password string
    Age      int
    Avatar   *string
}

// empty 判断 reflect.Value 是否为空（零值或 nil）
func empty(v reflect.Value) bool {
    switch v.Kind() {
    case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64:
        return v.Int() == 0
    case reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64:
        return v.Uint() == 0
    case reflect.String:
        return v.String() == ""
    case reflect.Bool:
        return !v.Bool()
    case reflect.Ptr, reflect.Slice, reflect.Map, reflect.Interface, reflect.Chan, reflect.Func:
        return v.IsNil()
    case reflect.Struct:
        // 可选：对嵌套结构体递归判断是否全为空（此处简化为视为非空，避免深度遍历开销）
        // 若需严格语义，可扩展实现结构体字段全空才返回 true
        return false
    case reflect.Float32, reflect.Float64:
        return v.Float() == 0
    default:
        // 其他类型（如 complex、unsafe.Pointer）按需补充；此处保守返回 false 避免误判
        return false
    }
}

func nonEmptyFieldNames(v interface{}) []string {
    rv := reflect.ValueOf(v)
    if rv.Kind() == reflect.Ptr {
        rv = rv.Elem()
    }
    if rv.Kind() != reflect.Struct {
        panic("nonEmptyFieldNames: input must be a struct or *struct")
    }

    var names []string
    rt := rv.Type()
    for i := 0; i < rv.NumField(); i++ {
        field := rv.Field(i)
        if !empty(field) {
            names = append(names, rt.Field(i).Name)
        }
    }
    return names
}

func main() {
    name := "Robert"
    u := Users{
        Name:     "Robert",
        Password: "",      // 空字符串 → 跳过
        Age:      0,       // 零值 int → 跳过
        Avatar:   &name,   // 非 nil 指针 → 保留
    }

    fmt.Println(nonEmptyFieldNames(u)) // 输出: [Name Avatar]
}