Go 语言是一门充满学问的语言，开发者如果不充分了解这些学问，一不小心就会掉入“陷阱”，这里来分享一个经典的nil != nil的问题。

在 Go 语言中，"接口值为 nil 但不等于 nil" 的现象源于接口类型独特的底层表示结构。

这看似矛盾的现象可以通过理解接口的内部实现来理解。

接口的内部结构

Go 语言的接口变量实际上由两个属性构成：

// $GOROOT/src/runtime/runtime2.go
type iface struct {
    tab  *itab       // 类型信息指针
    data unsafe.Pointer // 实际数据指针
}
  • 类型信息 (tab)：描述接口存储的具体类型及其方法集
  • 数据指针 (data)：指向实际存储的值

既然一个接口（interface）有两个属性组成，那么一个接口要等于nil就必须满足：

tab == nil && data == nil

只有两个属性都等于nil，那么这个接口才等于nil。

问题场景（"nil 接口" ≠ nil）

这里来看一个例子，定义一个具体类型指针p和一个接口i，两者均为nil，然后p赋值给接口i：

package main

import (
    "fmt"
)

type Person struct {
    Name string
    Age  int
}

func (p *Person) String() string {
    if p == nil {
        return "<nil Person>"
    }
    return fmt.Sprintf("Name: %s, Age: %d", p.Name, p.Age)
}

func main() {
    var p *Person = nil   // 具体类型的 nil 指针
    var i interface{}     //
    fmt.Println(p == nil) // output: true
    fmt.Println(i == nil) // output: true

    // 赋值给接口
    i = p
    fmt.Println(p == nil) // output: true
    fmt.Println(i == nil) // output: false, p 为 nil，而 i 不为 nil
}

当我们把具体类型p的 nil 值赋值给接口i时，接口i的内部属性发生了变化：

tab  => 包含 *Person 类型信息 (非nil)
data => nil

通过反射可以获得接口的类型和具体值：

fmt.Println(reflect.TypeOf(i), reflect.ValueOf(i))
// output: *main.Person <nil>

之所以这么设计，使接口能够保留关键的类型信息，即便值是nil，但也能知道它所“持有”的类型，并且即使值为nil也能正确调用它的方法：

package main

import (
    "fmt"
)

type Person struct {
    Name string
    Age  int
}

func (p *Person) String() string {
    if p == nil {
        return "<nil Person>"
    }
    return fmt.Sprintf("Name: %s, Age: %d", p.Name, p.Age)
}

func main() {
    var p *Person = nil   // 具体类型的 nil 指针
    var i interface{} = p // 赋值给接口

    fmt.Println(i) // output: <nil Person>，正常调用`String()`方法
}

踩坑及解决方案

举个例子，这就是一种常见的踩坑记录：

func returnsError() error {
    var p *MyError = nil // 具体类型的 nil
    return p // 此时 error != nil!
}

func main() {
    err := returnsError()
    if err != nil { // 条件成立！虽然返回的 p 是 nil 
        fmt.Println("Unexpected error:", err) 
    }
}

那该如何避免这种情况呢？这里列举几种解决方案：

  • 返回明确的 nil
func safeReturn() error {
    if condition {
        return nil // 真正的 nil 接口
    }
    return errors.New("error")
}
  • 使用类型断言验证
if err != nil {
    if myErr, ok := err.(*MyError); ok && myErr == nil {
        // 处理"假 nil"情况
    }
}
  • 反射判断其值是否为 nil
fmt.Println(reflect.ValueOf(err).IsNil())

最后

Go 的接口设计是类型信息的「运行时容器」，即使承载的是具体类型的零值（包括 nil），接口依然通过类型指针保留了完整的类型上下文。这种设计确保了：

  • 方法动态派发的正确性
  • 接口行为的可预测性
  • 反射系统的完整性

理解接口的双指针结构（类型信息+数据指针）是掌握 Go 语言 nil 处理精髓的关键。