Nil в Go: что такое nil, почему в Go нет null и где чаще всего ошибаются разработчики

Что такое nil в Go

nil — это не отдельный тип данных, это нулевое значение, которое может использоваться только для определённых типов.

var ptr *int
fmt.Println(ptr)

<nil>

var users []string
var cache map[string]int
var ch chan int
var fn func()
var v interface{}

type User struct {
Name string
}

var user *User
fmt.Println(user.Name)

Какие типы могут быть nil

var p *int
var s []int
var m map[string]int
var ch chan int
var fn func()
var v interface{}

Какие типы не могут быть nil

int
float64
bool
string
struct
array

var age int = nil

Почему var x = nil не компилируется

var x = nil

var x *int = nil
var y []string = nil
var z map[string]int = nil

var x *int
var y []string
var z map[string]int

Можно ли назвать переменную nil

func main() {
nil := 123
fmt.Println(nil)
}

Nil и нулевые значения (Zero Values)

var age int
var active bool
var name string

var ptr *int
var users []string
var cache map[string]int

nil — это zero value, но только для части типов

Почему это вообще удобно

var count int
count++
fmt.Println(count) // 1

var s string
s += "go"
fmt.Println(s) // go

Zero value на примере структуры

type User struct {
ID int
Name string
Email *string
}
var u User
fmt.Printf("%+v", u)

{ID:0 Name: Email:<nil>}

var empty string = ""
var missing *string = nil

Почему в Go нет привычного null

Где бывает nil: pointer, slice, map, channel, func, interface

Nil pointer и panic

panic: runtime error: invalid memory address or nil pointer dereference

var age *int
fmt.Println(*age)

Почему это происходит

Как защититься

if age != nil {
fmt.Println(*age)
}

func PrintAge(age *int) {
if age == nil {
fmt.Println("Возраст не указан")
return
}
fmt.Println(*age)
}

Panic возникает не только на *ptr

type User struct {
Name string
}
var user *User
fmt.Println(user.Name)

Живой пример из API

type UpdateUserRequest struct {
Name *string `json:"name"`
Age *int `json:"age"`
}

fmt.Println(*req.Name)

if req.Name != nil {
fmt.Println(*req.Name)
}

Nil slice vs empty slice

var a []int

b := []int{}
c := make([]int, 0)

fmt.Println(a == nil) // true
fmt.Println(b == nil) // false
fmt.Println(c == nil) // false
fmt.Println(len(a)) // 0
fmt.Println(len(b)) // 0
fmt.Println(len(c)) // 0

Что можно делать с nil slice

var nums []int
fmt.Println(len(nums)) // 0
nums = append(nums, 10)
nums = append(nums, 20)
fmt.Println(nums) // [10 20]

Где разница с empty slice реально важна

type Response struct {
Items []string `json:"items"`
}

{"items":null}

{"items":[]}

Практическое правило

Items: []string{}

Nil map: читать можно, писать нельзя

var scores map[string]int

fmt.Println(scores["go"]) // 0

value, ok := scores["go"]
fmt.Println(value) // 0
fmt.Println(ok) // false

scores["go"] = 100

assignment to entry in nil map

Почему читать можно, а писать нельзя

Как правильно

scores := make(map[string]int)
scores["go"] = 100

Пример ошибки

type Cache struct {
Values map[string]int
}
func main() {
c := Cache{}
c.Values["x"] = 1
}

c := Cache{
Values: make(map[string]int),
}

Nil channel: блокировка навсегда

var ch chan int

ch <- 10

value := <-ch
fmt.Println(value)

close(ch)

Почему это неприятно

Где nil channel реально используется

Главная ловушка: nil interface

var v interface{}
fmt.Println(v == nil) // true

var p *int = nil
var v interface{} = p
fmt.Println(v == nil) // false

Как interface устроен под капотом

Почему это ломает код

type MyError struct{}
func (e *MyError) Error() string {
return "boom"
}
func run() error {
var err *MyError = nil
return err
}

err := run()
fmt.Println(err == nil)

Как правильно

func run() error {
return nil
}

Как это объяснить на собеседовании

Интерфейс равен nil только тогда, когда у него одновременно нет и динамического типа, и значения. Если внутрь положить nil-указатель конкретного типа, значение будет nil, но тип уже задан, значит сам interface не nil.

New vs Make: где тут nil

Что делает new

p := new(int)
fmt.Println(*p) // 0
fmt.Println(p==nil) // false

Что делает make

s := make([]int, 0)
m := make(map[string]int)
ch := make(chan int)

Почему это важно именно для nil

var m map[string]int
fmt.Println(m == nil) // true

m := make(map[string]int)
fmt.Println(m == nil) // false

var s []int
fmt.Println(s == nil) // true
s2 := make([]int, 0)
fmt.Println(s2 == nil) // false

Простое правило

Nil в JSON, API и реальных задачах

Nil в JSON

type User struct {
Name string `json:"name"`
Telegram *string `json:"telegram"`
}

{
"name": "Niyaz",
"telegram": null
}

Почему указатели часто используют в DTO

type UpdateUserRequest struct {
Name *string `json:"name"`
Age *int `json:"age"`
}

Где лучше не плодить указатели без нужды

type User struct {
ID *int
Name *string
Active *bool
}

type User struct {
ID int
Name string
Active bool
}

Частые ошибки новичков и FAQ по собеседованиям

FAQ: что любят спрашивать на собеседовании

Шпаргалка по nil в Golang