Семантическое версионирование

SemVer — конвенция MAJOR.MINOR.PATCH, описывающая совместимость версий.

Почему это важно: Без понимания SemVer обновления превращаются в рулетку: minor-версия может неожиданно сломать код.

Главная идея

MAJOR ломает совместимость, MINOR добавляет фичи, PATCH исправляет баги без изменения API.

Как это выглядит на практике

Библиотека вышла в версии 2.3.1.
Патч 2.3.2 — исправление бага, безопасно обновлять.
Minor 2.4.0 — новая фича, обратно совместимая.
Major 3.0.0 — изменён API, нужно читать changelog и править код.

Что происходит под капотом

Операторы версий: ^2.3.1 (npm) разрешает 2.x.x, ~> 2.3 (Ruby) разрешает 2.x.
До версии 1.0.0 правила не действуют — любое изменение может сломать совместимость.
SemVer — это контракт, но не все библиотеки его честно соблюдают.
Lock-файл защищает от 'случайного' обновления даже при широких диапазонах в манифесте.

Типичные ошибки и заблуждения

Ошибка: minor-обновление всегда безопасно. Библиотеки часто ломают API в minor-релизах.
Ошибка: major-обновление обязательно сложное. Иногда это косметика с переименованием.
Ошибка: SemVer — закон. Это соглашение, которое каждый автор может трактовать по-своему.
Ошибка: точные версии (без диапазона) не нужны. Они часто спасают production.

Ключевые выводы

Читайте changelog перед major-обновлением.
Диапазоны в манифесте + lock-файл = гибкость и стабильность.
Pre-1.0 библиотеки трактуйте как 'может сломаться в любой момент'.
Автоматические security-обновления — хорошая практика для patch-версий.

Термины урока

SemVer: Semantic Versioning, стандарт MAJOR.MINOR.PATCH.

Breaking change: изменение, несовместимое с предыдущей версией.

Changelog: файл с описанием изменений между версиями.

Pinning: закрепление точной версии зависимости.

Связь с работой backend-разработчика

Регулярное чтение changelog'ов — скучная, но важная часть работы backend-разработчика. Это экономит дни отладки после обновлений.

Мини-разбор реальной ситуации

Обновили Rails с 7.0 до 7.1 — minor, без проблем ожидаемо. Оказалось, изменили поведение strong parameters в edge-кейсах, и тесты упали. Changelog предупреждал об этом.

Что запомнить

MAJOR = breaking.
Lock-файл — страховка.
Pre-1.0 = 'всё может поменяться'.

Итог

SemVer — простой, но часто нарушаемый контракт. Будьте осторожны с обновлениями, даже 'безопасными'.