反射空值

Go 的 reflect.Value.IsNil 不是适用于所有类型的“空值判断”。它只接受 Chan、Func、Interface、Map、Ptr、Slice 这些 Kind；对整数、字符串、结构体或无效 Value 直接调用，会触发 panic。通用反射代码应先判断 IsValid，再根据 Kind 决定能否调用 IsNil。

假设配置读取器把任意字段交给统一的“是否为空”函数，整数 0 和 nil 指针会走到同一个入口。问题不在于数据异常，而在于函数把缺失、nil、类型零值和空容器当成了同一件事。

官方文档：https://pkg.go.dev/reflect

先分清缺失、nil 和零值

这些分类不是随便换一个函数就能互相替代。比如配置里的数值 0 可能是合法值，而缺失字段才应该启用默认配置。若统一写成“为空就跳过”，即使避免了 panic，也可能丢失业务含义。

给 IsNil 设置明确的 Kind 范围

下面的示例返回状态文本，而不是马上给出“是否为空”的业务结论。这样调用方还能区分缺失值与不适用的类型。示例未在本文制作过程中执行。

package main

import (
    "fmt"
    "reflect"
)

// NilState 保留无效值和不适用状态，不把它们混成一个布尔答案。
func NilState(v reflect.Value) string {
    if !v.IsValid() {
        return "无效 Value"
    }
    switch v.Kind() {
    case reflect.Chan, reflect.Func, reflect.Interface,
        reflect.Map, reflect.Ptr, reflect.Slice:
        if v.IsNil() {
            return "nil"
        }
        return "非 nil"
    default:
        return "该 Kind 不适用 IsNil"
    }
}

func main() {
    var pointer *int
    var items []string
    samples := []struct {
        name string
        value any
    }{
        {"空接口", nil},
        {"带类型的空指针", pointer},
        {"nil 切片", items},
        {"非 nil 空切片", []string{}},
        {"整数零值", 0},
        {"空字符串", ""},
    }
    for _, item := range samples {
        // 仅输出分类，不读取或调用任何值里的业务方法。
        fmt.Printf("%s: %s\n", item.name, NilState(reflect.ValueOf(item.value)))
    }
}

switch 不是为了列举几个特例，而是把 IsNil 的适用范围变成可见契约。后续增加新的输入类型时，默认分支仍能清楚表达“不适用”，不会偷偷把字符串或数字送进 IsNil。

不要仅用 recover 把所有反射 panic 转成“是空值”。这样会把类型使用错误伪装成正常业务状态，也很难判断错误来自无效 Value 还是不支持的 Kind。

接口里装着 nil 指针时看哪一层

接口变量可能有具体类型，但其承载的指针为 nil。ValueOf 会取得接口中存放的具体值，因此得到的 Kind 可能是 Ptr，而不是 Interface。若需要观察接口变量这一层，可取接口变量地址再 Elem。

// 沿用前例的 fmt、reflect 导入，将片段放到函数体中。
var pointer *int
var box any = pointer

dynamic := reflect.ValueOf(box)          // 取得接口中存放的具体指针值。
slot := reflect.ValueOf(&box).Elem()     // 取得接口变量自身的反射值。
fmt.Println(NilState(dynamic))
fmt.Println(NilState(slot))
if slot.IsValid() && slot.Kind() == reflect.Interface && !slot.IsNil() {
    // 接口这一层非 nil，不代表它承载的具体指针非 nil。
    fmt.Println(NilState(slot.Elem()))
}

例子中的 box 自身含有动态类型，所以不能把接口这一层直接称为 nil；但它里面的具体指针为 nil。两者并不矛盾。检查指针能否使用与判断接口变量是否未赋值，本来就是不同的问题。

不要无限调用 Elem 试图“拆到最后”。只有指针与接口等合适的值才允许相应解引用，而且 nil 解引用得到的反射结果还需要重新检查有效性。通用遍历器必须在每一层保留类型和缺失策略。

空切片不是 nil 切片

nil 切片与 []string{} 都可能长度为 0，但后者是非 nil 切片。若业务只关心有没有元素，应在确认 Kind 后检查 Len；若业务需要区分未设置和显式提供空列表，就不能只看长度。

IsZero 也不是“容器长度为零”的同义词。对切片来说，nil 是该类型的零值，已初始化的空切片并不因此成为零值。对无效 Value，IsZero 同样不能直接调用。

整数 0、false、空字符串各有自己的零值语义，却都不因此获得 IsNil 的适用资格。先决定业务要排除什么状态，再选择反射方法，通常比写一个含糊的 IsEmpty 更容易维护。

将判断接入反射读取流程

接入字段读取器时，可采用三个明确约定：找不到字段返回缺失状态；找到字段后根据 Kind 做类型判断；最后由业务决定 nil、零值或空集合是否允许。不要在取值阶段顺便吞掉这些差异。

例如 MapIndex 查不到键会返回无效 Value，值本身为 nil 指针时则是有效的 Ptr。调用者如果先用 IsValid 区分，就能保留“键不存在”和“键存在但值为 nil”的含义。

读者可用 nil 接口、nil 指针、非 nil 指针、nil 切片、空切片、整数零值和缺失映射键分别检查分类。结果应匹配事先约定的语义；不能以“没有 panic”作为判断函数已经正确的唯一标准。

常见问题

IsValid 为 true 后就能调用 IsNil 吗？

还不能。有效的整数或结构体仍不适用 IsNil，需要继续判断 Kind。

Kind 为 Interface 时 IsNil 为 false，里面还能是 nil 吗？

可以承载具体类型的 nil 值。应按需求检查接口自身或其中的动态值，不要混为一层。

想判断所有类型的零值，能用 IsNil 替代 IsZero 吗？

不能。两者适用范围和语义不同，而且 IsZero 也要求 Value 有效。