Добавить объявление

Эволюция enum: больше не надо бояться добавлять новые кейсы

Swift всегда балансировал между безопасностью и гибкостью. С одной стороны строгий компилятор, который заставляет обрабатывать все возможные случаи. С другой - реальная разработка, где требования меняются, и API должен эволюционировать. Особенно остро это противоречие ощущалось в перечислениях: добавление нового кейса в публичный enum ломало обратную совместимость, заставляя авторов библиотек либо плодить новые типы, либо вообще избегать enum в публичном API.

С выходом Swift 6.2.3 этот многолетний компромисс наконец-то разрешается. Новый атрибут @nonexhaustive меняет правила игры, позволяя enum'ам расти без боли для пользователей библиотек.

Проблема, знакомая каждому:


Представьте библиотеку для работы с API погоды. Вы создаете enum для условий:

public enum WeatherCondition {
case sunny
case cloudy
case rainy
}

Пользователи пишут switch, обрабатывая все случаи. Проходит время, и вы понимаете, что нужно добавить case snowy. В традиционном Swift это немедленно приводило к проблеме совместимости: любой код, где производился полный перебор всех кейсов switch, переставал компилироваться, так как обработка переставала быть полноценной.

Вы оказываетесь перед выбором: либо выпускать мажорную версию и смириться с нарушением обратной совместимости или вообще отказаться от использования enum, заменив его на менее типобезопасную структуру со статическими свойствами.

Решение - @nonexhaustive:


Новый атрибут меняет правила игры. Помечая enum как @nonexhaustive, вы говорите компилятору: «Этот enum может расширяться в будущем».

@nonexhaustive
public enum WeatherCondition {
case sunny
case cloudy
case rainy
}

Теперь компилятор запрещает пользователям делать exhaustive switch без @unknown default. Это заставляет их заранее предусмотреть возможность будущих расширений. Когда вы позже добавите case snowy, код пользователей с @unknown default продолжит работать корректно.

Плавная миграция с @nonexhaustive(warn):


Для существующих кодовых баз предусмотрен миграционный путь. Атрибут @nonexhaustive(warn) сначала показывает предупреждение, давая пользователям время адаптировать код, прежде чем требование станет ошибкой. Это пример вдумчивого дизайна, учитывающего реальные условия работы с legacy-кодом.

Когда что выбрать:


@frozen - для перечислений, которые фундаментальны и никогда не изменятся, как Optional или Result. Это обещание навсегда, дающее компилятору право на максимальные оптимизации.

@nonexhaustive - новый стандарт для публичных API библиотек. Подходит для статусов, кодов ошибок, категорий всего, что может эволюционировать со временем.

Обычный enum без атрибутов теперь стоит рассматривать как выбор для внутренней реализации, где вы контролируете весь код и хотите строгой проверки.

Вывод:


Введение @nonexhaustive в Swift 6.2.3 - это важная веха в эволюции языка. Оно показывает зрелость Swift как платформы для создания долгоживущих, эволюционирующих систем. Язык начинает предлагать инструменты не только для написания кода, но и для управления его изменением во времени.

Это изменение признает фундаментальную истину разработки ПО: требования меняются, системы растут, и наши инструменты должны помогать нам адаптироваться к этим изменениям, а не становиться препятствием. @nonexhaustive дает библиотекам свободу развиваться, сохраняя при этом безопасность типов и ясность API - редкое сочетание, которое делает Swift еще более привлекательным для создания серьезных, долгосрочных проектов.
28.01.2026 11 554