Go 中跳过结构体空字段的遍历方法

本文介绍如何使用反射机制遍历 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]
}

✅ 关键说明：

• empty() 函数覆盖了常见类型（数值、字符串、布尔、指针、切片、映射等），并正确处理 nil 和零值语义；
• nonEmptyFieldNames() 支持传入结构体值或指针，自动解引用，提升调用灵活性；
• 对 struct 类型未做递归判空（因“空结构体”无统一定义），若业务需要可按字段逐层检查；
• 浮点数、复数等类型已补充支持，确保健壮性；
• 注意：反射有运行时开销，高频场景建议结合代码生成（如 go:generate + structtag）替代。

? 最佳实践提示：

• 若结构体字段带有自定义标签（如 json:"name,omitempty"），可进一步结合 reflect.StructTag 实现更精细的过滤逻辑；
• 生产环境建议对 reflect.Value 的 CanInterface() 进行校验，避免 panic（本例中已通过类型约束规避）；
• 对性能敏感路径，应优先考虑显式字段检查而非反射，反射更适合配置驱动或低频元编程场景。