Калькулятор SemVer

Что показывает этот калькулятор

Для версии вроде 1.2.3 инструмент показывает четыре предлагаемые следующие версии:

Повышение minor сбрасывает patch до 0; повышение major сбрасывает и minor, и patch до 0. Предложение prerelease помечает следующий patch как кандидата в релиз. Инструменты командной строки вроде npm version добавляют больше операций (premajor, preminor, prepatch, а также инкременты prerelease на месте, например 1.2.3-beta.1 становится 1.2.3-beta.2), если они нужны вам в скрипте релиза.

Правила приоритета, с которыми вы столкнётесь

• Предварительный выпуск имеет низший приоритет по сравнению с официальным выпуском: 1.0.0-rc.1 < 1.0.0.
• Числовые идентификаторы сравниваются числовым образом; буквенно-цифровые идентификаторы сравниваются лексически: 1.0.0-alpha.2 < 1.0.0-alpha.11.
• Метаданные build (+sha.abc) не учитываются при определении приоритета; версии 1.0.0+20240101 и 1.0.0+20250101 считаются равными.
• Ведущий ноль в числовом идентификаторе недопустим. 1.0.0-rc.01 не является semver; используйте rc.1.

Краткая таблица диапазонов значений

• ^1.2.3, любая версия, соответствующая или превышающая 1.2.3 и ниже 2.0.0 (сохраняет ту же основную версию).
• ~1.2.3, любая версия, не менее 1.2.3 и менее 1.3.0 (сохраняет ту же подверсию).
• >=1.2.3 <2.0.0, явный диапазон.
• 0.x является особенным случаем: npm классифицирует ^0.2.3 как >=0.2.3 <0.3.0, поскольку версии до 1.0 считаются нестабильными.

Когда повышать основную версию

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