Как проверить, содержит ли карта (map) определенный ключ в Go?

Идиоматический способ: проверка с помощью второго возвращаемого значения

В Go есть встроенный синтаксис для проверки наличия ключа в map. При обращении к элементу map можно получить два значения: само значение (если ключ существует) и булево значение, указывающее, присутствует ли ключ в карте. Вот как это работает:

users := map[int]string{
    1: "Alice",
    2: "Bob",
    3: "",
}

// Проверка с использованием второго возвращаемого значения
if value, exists := users[1]; exists {
    fmt.Printf("Ключ 1 существует, значение: %q\n", value)
} else {
    fmt.Println("Ключ 1 не найден")
}

// Проверка для несуществующего ключа
if _, exists := users[4]; exists {
    fmt.Println("Ключ 4 существует")
} else {
    fmt.Println("Ключ 4 не найден")
}

// Проверка для ключа с пустой строкой
if value, exists := users[3]; exists {
    fmt.Printf("Ключ 3 существует, значение: %q\n", value)
}

Вывод:

Ключ 1 существует, значение: "Alice"
Ключ 4 не найден
Ключ 3 существует, значение: ""

Как это работает

Синтаксис value, ok := map[key] — это идиома Go. Переменная ok (можно называть как угодно, но традиционно используется ok или exists) будет равна true, если ключ присутствует в карте, и false в противном случае. Если ключа нет, value получает нулевое значение для типа карты. Но в отличие от простой проверки if map[key] != zeroValue, этот метод работает корректно для любых значений, включая нулевые.

Практический пример с разными типами

// Map с числовыми значениями
scores := map[string]int{
    "Alice": 95,
    "Bob":   0,    // Валидное значение
}

// ❌ Неправильно: не различает отсутствие ключа и 0
if scores["Bob"] != 0 {
    fmt.Println("Bob есть") // Не выполнится, хотя Bob есть!
}

// ✅ Правильно: используем второе возвращаемое значение
if score, ok := scores["Bob"]; ok {
    fmt.Printf("Bob есть, его счет: %d\n", score)
}

// Map с булевыми значениями
features := map[string]bool{
    "dark_mode": true,
    "notifications": false,
}

if _, ok := features["notifications"]; ok {
    fmt.Println("Ключ notifications существует (значение false)")
}

Только проверка существования (без получения значения)

Если вам нужно только проверить наличие ключа, а значение не интересует, используйте _ для игнорирования значения:

if _, ok := users[2]; ok {
    fmt.Println("Пользователь 2 существует")
}

Важные моменты

• Не используйте сравнение с нулевым значением — это ненадежно, если нулевое значение является валидным.
• Идиома value, ok := map[key] — стандарт Go, принятый во всем сообществе. Код с такой проверкой легко читается и понимается другими Go-разработчиками.
• Для удаления ключа используйте delete(map, key), но перед этим проверка на существование не обязательна — удаление несуществующего ключа безопасно.
• Производительность: такая проверка выполняется за O(1) в среднем, как и обычное чтение из map.

Этот подход — один из краеугольных камней работы с map в Go. Запомните его, и вы избежите многих ошибок, связанных с нулевыми значениями.

// Generic функция для проверки наличия ключа в map
func keyExists[K comparable, V any](m map[K]V, key K) bool {
    _, ok := m[key]
    return ok
}

// Использование
users := map[int]string{1: "Alice", 2: "Bob"}
fmt.Println(keyExists(users, 1)) // true
fmt.Println(keyExists(users, 3)) // false