Go reflect.Value.IsNil 可检查哪些 Kind

使用反射判断“这个值是不是 nil”时，reflect.Value.IsNil 不是对所有 Kind 都开放。可以调用它的 Kind 包括 Chan、Func、Interface、Map、Pointer、Slice 和 UnsafePointer；对整数、字符串、数组或结构体调用会触发 panic。还有一个容易漏掉的边界：reflect.ValueOf(nil) 返回无效的零 Value，必须先检查 IsValid。

IsNil 到底支持哪些 Kind

官方文档把支持范围描述为 channel、function、interface、map、pointer 和 slice；当前 reflect 实现的 Kind 分支还明确包含 UnsafePointer。因此写反射工具时，可以把下面七类看成完整的可空值白名单。

Int、Bool、String、Array 和 Struct 不在这个范围。它们即使具有“零值”，也应该分别使用直接比较、IsZero 或类型专用方法判断。

先处理无效 Value，再判断 typed nil

这两个例子看起来都和 nil 有关，但反射结果不同：

• var x any = nil 后执行 reflect.ValueOf(x)，得到的是无效 Value，IsValid 为 false。
• var p *int = nil; var x any = p 后执行 reflect.ValueOf(x)，得到有效的 Pointer Value，IsNil 为 true。

因此“接口里装了 nil 指针”和“接口本身为 nil”不能混为一谈。对外暴露的反射辅助函数还应明确：无效 Value 是返回 true、返回 false，还是单独返回一个状态。

用 Kind 白名单封装，避免反射 panic

如果调用方只想知道“是否为可空引用且当前为空”，用两个返回值比把无效值强行当作 nil 更清楚：

package nilcheck

import "reflect"

// IsNilLike 只在可空 Kind 上调用 IsNil；第二个返回值表示 Kind 是否支持该判断。
func IsNilLike(v reflect.Value) (isNil bool, supported bool) {
	// ValueOf(nil) 会得到无效 Value，不能直接调用 IsNil。
	if !v.IsValid() {
		return false, false
	}

	switch v.Kind() {
	case reflect.Chan, reflect.Func, reflect.Interface,
		reflect.Map, reflect.Pointer, reflect.Slice, reflect.UnsafePointer:
		// 只有白名单中的 Kind 才进入 IsNil，避免 reflect.ValueError panic。
		return v.IsNil(), true
	default:
		// 数值、字符串、数组和结构体的零值不是 IsNil 的职责。
		return false, false
	}
}

调用方可以据此区分三种结果：supported=true,isNil=true 表示可空值确实为空；supported=true,isNil=false 表示有值；supported=false 表示无效 Value 或不适合用 IsNil 判断。若业务明确把“缺失参数”也视为 nil，可在函数外层单独转换，而不要隐藏这个语义差异。

IsNil、IsZero 和普通比较不要混用

IsNil 只回答“引用是否为空”。例如空但非 nil 的 slice，其长度可以是 0，但 IsNil 返回 false；nil map 也可以被读取并表现为空，却仍然是 nil。需要判断任意类型的零值时用 IsZero，需要判断具体业务对象时优先使用类型安全的比较。

实战检查可以按这个顺序进行：先确认 Value 是否有效；再确认 Kind 是否在白名单；最后才调用 IsNil。如果只想处理指针和接口，白名单还可以继续缩小，错误也会更早暴露。

相关问题

reflect.ValueOf(nil).IsNil 为什么会 panic？

因为 ValueOf(nil) 返回的是无效 Value，Kind 为 Invalid，不属于 IsNil 的支持范围。先调用 IsValid 做分支。

nil slice 和空 slice 的 IsNil 结果一样吗？

不一样。nil slice 的 IsNil 为 true；通过字面量或 make 创建的空但非 nil slice，IsNil 为 false，长度都可能是 0。

IsNil 能判断 int 的零值吗？

不能。int 不支持 IsNil，应直接与 0 比较，或在需要统一零值语义时使用 IsZero。