PassFront
  1. PassFront
  2. База знаний
  3. Менеджеры пакетов

Что означают ^ и ~ в версиях пакетов и как работает semver?

Менеджеры пакетов

Semver — договорённость о номерах версий в формате MAJOR.MINOR.PATCH. Символы ^ и ~ задают, какие обновления разрешены при установке.

{
  "dependencies": {
    "react": "^18.3.0",
    "zod": "~3.23.8",
    "left-pad": "1.3.0"
  }
}

Semver

  • PATCH — (1.2.3 → 1.2.4): исправления без изменения поведения.
  • MINOR — (1.2.3 → 1.3.0): новые возможности, обратно совместимые.
  • MAJOR — (1.2.3 → 2.0.0): ломающие изменения.

Диапазоны

  • ^1.2.3 разрешает всё от 1.2.3 до 2.0.0 (не включая). Это значение по умолчанию.
  • ~1.2.3 разрешает только патчи: от 1.2.3 до 1.3.0.
  • 1.2.3 без символа фиксирует точную версию.
  • Для версий 0.x правила строже: ^0.2.3 разрешает только 0.2.x.

На практике

Автор может нарушить semver, поэтому «безопасное» обновление иногда ломает проект. Точные версии лежат в lock-файле, а не в package.json.

Коротко для собеседования

MAJOR ломает совместимость, MINOR добавляет, PATCH чинит. ^ разрешает минорные и патчи, ~ только патчи.

Подробнее: Semantic Versioning

Другие вопросы раздела