В чем разница между объявлением map через var и через присваивание?

Разница между объявлением map через var и присваиванием

Основное различие между объявлением var m map[keyType]valueType и m := make(map[keyType]valueType) (или m := map[keyType]valueType{}) заключается в том, что в первом случае создается нулевое значение (nil map), а во втором — инициализированная пустая мапа.

1. Объявление через var

При использовании var переменная получает нулевое значение для типа map, то есть nil. Это означает, что map объявлена, но не инициализирована — под нее не выделена память.

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

Ключевые особенности nil map:

• Можно безопасно читать (вернет нулевое значение типа значения)
• Нельзя модифицировать — попытка записи вызовет panic
• Не требует предварительного выделения памяти (пока не инициализирована)

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

var m map[string]int
m["key"] = 42 // panic: assignment to entry in nil map

2. Создание через make() или литерал

При использовании make() или литерала создается инициализированная пустая map, готовая к использованию.

Вариант с make():

m := make(map[string]int)
// или с указанием начальной емкости
m := make(map[string]int, 10)

Вариант с литералом:

m := map[string]int{}
// или с начальными значениями
m := map[string]int{"a": 1, "b": 2}

Характеристики инициализированной map:

• Готова к чтению и записи
• Не равна nil (если не была специально присвоена)
• Выделена память под структуру map

Сравнительная таблица

Практические рекомендации

1. Когда использовать var объявление:
   • Когда map будет инициализирована позже, возможно, в другой функции
   • В структурах, где инициализация происходит в конструкторе или методе
   • Для глобальных переменных, которые инициализируются в init() функции

var globalCache map[string]interface{}

func init() {
    globalCache = make(map[string]interface{})
}

1. Когда использовать make() или литерал:
   • При локальном создании map для немедленного использования
   • Когда нужна предварительная установка емкости для оптимизации производительности
   • При создании встроенных map в структурах

func processData() {
    // Локальная map, сразу готовая к использованию
    counts := make(map[string]int, 100)
    
    // Или с литералом и начальными значениями
    defaults := map[string]bool{"enabled": true, "debug": false}
}

1. Особый случай — возврат из функций:

// Потенциально опасно — возвращает nil map
func createMap() map[string]int {
    var m map[string]int
    return m // возвращает nil
}

// Безопасно — возвращает пустую, но инициализированную map
func createSafeMap() map[string]int {
    return make(map[string]int)
    // или return map[string]int{}
}

Подводные камни и best practices

1. Проверка на nil перед использованием:

   var m map[string]int
   
   if m == nil {
       m = make(map[string]int)
   }
   m["key"] = value // Теперь безопасно
   

2. Передача в функции: Оба типа можно передавать в функции, но только инициализированную map можно модифицировать внутри функции.

3. Производительность: Указание начальной емкости в make() может улучшить производительность, если известно примерное количество элементов.

4. JSON-сериализация: nil map сериализуется в JSON как null, а пустая map — как {}.

var nilMap map[string]int
emptyMap := make(map[string]int)

jsonNil, _ := json.Marshal(nilMap)    // "null"
jsonEmpty, _ := json.Marshal(emptyMap) // "{}"

Заключение

Выбор между var и make()/литералом зависит от контекста использования. Для map, которые будут немедленно использоваться для записи, всегда предпочтительна инициализация через make() или литерал. Объявление через var уместно, когда map должна быть инициализирована позже или условно. Понимание этой разницы критически важно для избежания runtime panic и написания корректного, эффективного Go-кода.