本文介绍如何使用反射机制遍历 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（本例中已通过类型约束规避）；
- 对性能敏感路径，应优先考虑显式字段检查而非反射，反射更适合配置驱动或低频元编程场景。
