Краткий справочник

Шпаргалка по семантическому версионированию (SemVer)

Краткий справочник по SemVer: правила инкремента MAJOR.MINOR.PATCH, теги пре-релизов, метаданные сборки и диапазоны пакетных менеджеров.

· Опубликовано

Семантическое версионирование (SemVer) определяет формальную спецификацию присвоения и изменения номеров версий ПО: MAJOR.MINOR.PATCH.

Три компонента версии

$$\text{Version} = \text{MAJOR}.\text{MINOR}.\text{PATCH}$$

  1. MAJOR (1.0.0 -> 2.0.0): Несовместимые изменения, ломающие обратную совместимость API.
  2. MINOR (1.0.0 -> 1.1.0): Новая функциональность с сохранением обратной совместимости.
  3. PATCH (1.0.0 -> 1.0.1): Исправления ошибок с сохранением обратной совместимости.

Пре-релизы и метаданные сборки

1.0.0-alpha
1.0.0-alpha.1
1.0.0-beta.2
1.0.0-rc.1
1.0.0+20261108   # Метаданные сборки (+игнорируются при сравнении старшинства версий)

Порядок старшинства: 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.


Спецификаторы диапазонов в пакетных менеджерах

Диапазон Включенные версии Описание
1.2.3 1.2.3 Точное совпадение версии
>1.2.3 1.2.4, 2.0.0, ... Строго больше
>=1.2.0 <1.3.0 1.2.0 up to 1.2.9 Ограниченный диапазон
~1.2.3 >=1.2.3 <1.3.0 Только обновления уровня patch
^1.2.3 >=1.2.3 <2.0.0 Совместимые обновления (разрешены minor и patch)
^0.2.3 >=0.2.3 <0.3.0 В версиях 0.x.x релиз minor считается ломающим совместимость
* Any version Любая версия (без ограничений)

Ссылки

Связанные темы