В чем разница между тильдой (~) и кареткой (^) в package.json?

Question

В чем разница между тильдой (~) и кареткой (^) в package.json?

2686

После того, как я обновился до последних стабильных node и npm, я попробовал npm install moment --save. Он сохраняет запись в package.json с префиксом caret(^). Раньше это был префикс tilde(~).

Почему эти изменения сделаны в npm?
В чем разница между tilde(~) и caret(^)?
В чем преимущества над другими?

Fizer Khan 12 март 2014, в 05:04

Источник

28

К вашему сведению, вы можете предотвратить префиксы или использовать пользовательские, выполнив: npm config set save-prefix='' . (Вставьте ~ в кавычки, если это то, что вы предпочитаете.) Я лично делаю это и упаковываю вещи в производство.
fncomp 22 янв. 2015, в 09:48
15

Все подробности о том, как работают тильда и карета, и различия: github.com/npm/node-semver#tilde-ranges-123-12-1
Jeffrey Martinez 13 окт. 2015, в 21:31
7

Этот инструмент отличный помощник для тестирования semver.npmjs.com
chaiyachaiya 13 дек. 2016, в 12:57
0

@fncomp просто хотел уточнить, правильно ли я понял ваш комментарий. Вы используете только определенные версии зависимостей в своем проекте? наша команда не решается обновить зависимости .. вы бы порекомендовали использовать конкретные версии или префикс '~' для зависимостей ..?
blogs4t 10 март 2018, в 17:56
0

@fncomp, не могли бы вы рассказать, что вы имеете в виду, говоря: «Я лично это делаю и упаковываю вещи в производство». Спасибо!
blogs4t 10 март 2018, в 18:43
0

Я использовал для удаления префикса, но с термоусадочной пленкой или блокировкой пакета это на самом деле не нужно. Смотрите: docs.npmjs.com/files/package-locks
fncomp 13 март 2018, в 04:48
0

Семантическое управление версиями в npm и узле
RBT 10 янв. 2019, в 08:33

Показать ещё 5 комментариев

Теги:

javascript

node.js

npm

16 ответов

708

Я также хотел бы добавить официальную документацию по npmjs, в которой описаны все методы, относящиеся к конкретным версиям, включая методы, упомянутые в вопросе.

https://docs.npmjs.com/files/package.json

https://docs.npmjs.com/misc/semver#x-ranges-12x-1x-12-

~version "Приблизительно эквивалентна версии" См. раздел npm - Tilde Ranges & semver (7)
^version "Совместимо с версией" См. npm semver - Caret Ranges & semver (7)
version должна точно соответствовать версии
>version должна быть больше версии
>=version т.д.
<version
<=version
1.2.x 1.2.0, 1.2.1 и т.д., Но не 1.3.0
http://sometarballurl (это может быть URL тарбола, который будет загружен и установлен локально
* Соответствует любой версии
latest Получает последний выпуск

Приведенный выше список не является исчерпывающим. Другие спецификаторы версий включают в себя URL-адреса GitHub и репозитории пользователей GitHub, локальные пути и пакеты с конкретными тегами npm.

Ahmad 16 сен. 2014, в 06:25

7

Также можно указать точный диапазон версий, например 1.2.0 || >=1.2.2 <1.3.0 : точно 1.2.0 или все от 1.2.2 до 1.3.0 (включительно), но не 1.2.1 или 1.3.1 и выше, а также не 1.1.x и ниже ,
CoDEmanX 08 июнь 2016, в 20:30
1

@CoDEmanX почему 1.3.0 включен, если вы используете < ?
Janus Troelsen 13 дек. 2016, в 14:30
1

Мой плохой, он должен был прочитать <=1.3.0 .
CoDEmanX 13 дек. 2016, в 15:43
0

1.xx возможен?
Venryx 24 фев. 2017, в 13:24
2

@Venryx да, это так. Это будет любая версия> = 1.0.0 и <2.0.0
Ahmad 24 фев. 2017, в 17:04
0

Более конкретная ссылка приведена выше -> docs.npmjs.com/files/package.json#dependencies
Toby 11 июль 2018, в 12:38

Показать ещё 4 комментария

399

Npm позволяет установить более новую версию пакета, чем указанная. Использование тильды (~) дает вам исправления ошибок, а символ вставки (^) также обеспечивает обратную совместимость новых функций.

Проблема в том, что старые версии обычно не получают исправлений ошибок, поэтому npm использует символ вставки (^) по умолчанию для --save.

Согласно: "Семвер объяснил - почему в моем package.json есть каретка (^)?" ,

Обратите внимание, что правила применяются к версиям выше 1.0.0, и не каждый проект следует семантическому версионированию. Для версий 0.xx каретка допускает только обновления патчей, то есть ведет себя так же, как тильда. Смотрите раздел "Кареты"

Вот наглядное объяснение понятий:

Источник: "Semantic Versioning Cheatsheet".

pspi 30 июль 2015, в 21:21

1

Как насчет ^ 0.2.5? из docs.npmjs.com/misc/semver#caret-ranges-1-2-3-0-2-5-0-0-4 : диапазоны карет ^ 1.2.3 ^ 0.2.5 ^ 0.0.4. Позволяет вносить изменения, которые не изменяют крайнюю левую ненулевую цифру в кортеже [major, minor, patch]. Другими словами, это позволяет использовать исправления и незначительные обновления для версий 1.0.0 и выше, обновления исправлений для версий 0.X> = 0.1.0 и не обновлять версии 0.0.X.
rofrol 11 окт. 2015, в 16:18
3

@rofrol любая версия до 1.0.0 считается нестабильной, и эти правила не применяются
pspi 04 нояб. 2015, в 09:35
2

Итак, ваше объяснение не завершено
rofrol 04 нояб. 2015, в 10:22
4

@rofrol Да, иногда плохое опускание для читабельности, шансы иметь что-либо ниже 1.0.0 для зависимости в пакете json довольно низки. см. также принцип 20/80, это отличное правило для того, чтобы сосредоточиться на том, что важно
pspi 04 нояб. 2015, в 16:42
0

Смотри мой ответ. Как вы думаете? stackoverflow.com/questions/22343224/...
rofrol 10 нояб. 2015, в 12:33
0

@pspi Наличие версий ниже 1.0.0 "маловероятно"? Из 60 у нас ~ 15, и большинство из них не совсем неизвестны.
Dave Newton 08 авг. 2016, в 21:08
0

@DaveNewton ой ... даже если версия выше 1.0.0, нет никаких гарантий, что проект следует за semver, хотя
pspi 09 авг. 2016, в 12:18
0

Это ужасный дефолт. Если последующие пакеты не могут поддерживать достаточную дисциплину, чтобы не сломать вещи, я всегда хочу точную версию того, что я просил. Не что-то еще.
EricRRichards 14 май 2018, в 15:16
0

@pspi ваш ответ гораздо яснее, чем любые другие ответы здесь
Mateen 21 сен. 2018, в 09:16

Показать ещё 7 комментариев

78

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

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

В дополнение к этому ^ не поддерживается старыми версиями npm и следует использовать с осторожностью.

Итак, ^ является хорошим дефолтом, но он не идеален. Я предлагаю тщательно выбрать и настроить наиболее удобный для вас оператор semver.

alex 13 март 2014, в 00:41

12

не соответствует действительности: диапазоны карет ^ 1.2.3 ^ 0.2.5 ^ 0.0.4. Позволяет вносить изменения, которые не изменяют крайнюю левую ненулевую цифру в кортеже [major, minor, patch]. Другими словами, это позволяет использовать исправления и незначительные обновления для версий 1.0.0 и выше, обновления исправлений для версий 0.X> = 0.1.0 и не обновлять версии 0.0.X. docs.npmjs.com/misc/semver#caret-ranges-1-2-3-0-2-5-0-0-4
rofrol 11 окт. 2015, в 16:08
5

Этот ответ совершенно неверен (как и многие другие здесь). Ни один из них никогда не исправит главное число! Как сказал @rofrol, ^ просто оставляет самую левую ненулевую цифру без изменений. С другой стороны, ~ разрешает только обновления патчей, если указана младшая версия (например, ~ 1.2.3 или ~ 1.2), и разрешает второстепенные обновления, если младшая версия не указана (например, ~ 1).
TheBaj 14 июль 2017, в 14:22
0

@TheBaj Они означают «исправить» как «определить» («fixate»), а не «настроить», так что вы все согласны с тем, как обрабатывается основное число.
maaartinus 10 июль 2018, в 21:41

Показать ещё 1 комментарий

72

Semver

<major>.<minor>.<patch>-beta.<beta> == 1.2.3-beta.2

Для тестирования используйте калькулятор npm. (Хотя объяснения ^ (включают в себя все, что больше определенной версии в том же основном диапазоне) и ~ (включают все, что выше определенной версии в том же младшем диапазоне) не являются на 100% правильными, калькулятор работает нормально )
В качестве альтернативы, используйте SemVer Check, который не требует выбора пакета, а также предлагает объяснения.

Разрешить или запретить изменения

Версия для пин- 1.2.3: 1.2.3.
Используйте ^ (как голова). Разрешает обновления на втором ненулевом уровне слева: ^0.2.3 означает 0.2.3 <= v < 0.3.
Используйте ~ (как хвост). Обычно замораживают самый правый уровень или устанавливают ноль, если опущен:
- ~1 означает 1.0.0 <= v < 2.0.0
- ~1.2 означает 1.2.0 <= v < 1.3.0.
- ~1.2.4 означает 1.2.4 <= v < 1.3.0.
Пропустить самый правый уровень: 0.2 означает 0.2 <= v < 1. Отличается от ~ потому что:
- Начиная с опущенной версии уровня всегда 0
- Вы можете установить начальную основную версию без указания подуровней.

Все (надеюсь) возможности

Установить начальный основной уровень и разрешить обновления вверх

*  or "" (empty string)   any version
1                         v >= 1

Заморозить основной уровень

~0 (0)            0.0 <= v < 1
0.2               0.2 <= v < 1          // Can't do that with ^ or ~ 
~1 (1, ^1)        1 <= v < 2
^1.2              1.2 <= v < 2
^1.2.3            1.2.3 <= v < 2
^1.2.3-beta.4     1.2.3-beta.4 <= v < 2

Заморозить второстепенный уровень

^0.0 (0.0)        0 <= v < 0.1
~0.2              0.2 <= v < 0.3
~1.2              1.2 <= v < 1.3
~0.2.3 (^0.2.3)   0.2.3 <= v < 0.3
~1.2.3            1.2.3 <= v < 1.3

Freeze patch-level

~1.2.3-beta.4     1.2.3-beta.4 <= v < 1.2.4 (only beta or pr allowed)
^0.0.3-beta       0.0.3-beta.0 <= v < 0.0.4 or 0.0.3-pr.0 <= v < 0.0.4 (only beta or pr allowed)
^0.0.3-beta.4     0.0.3-beta.4 <= v < 0.0.4 or 0.0.3-pr.4 <= v < 0.0.4 (only beta or pr allowed)

Запретить обновления

1.2.3             1.2.3
^0.0.3 (0.0.3)    0.0.3

Примечание: Отсутствует крупный, незначительный, патч или с указанием beta без номера, так же, как any пропавшего уровня.

Примечание: При установке пакета которым имеет 0 в качестве основного уровня, обновление будет только установить новую бета/пр версии уровня! Это потому, что npm устанавливает ^ по умолчанию в package.json и когда установленная версия похожа на 0.1.3, он замораживает все основные/второстепенные/патч-уровни.

rofrol 11 окт. 2015, в 18:44

0

Говорить людям, чтобы они не запускали проекты с 0, потому что разработчики из библиотек и потребителей не понимают систему, это ужасное решение. Я думаю, что @asdfasdfads имеет гораздо лучшую информацию.
ProLoser 22 сен. 2016, в 19:16
0

@ProLoser Я просто считаю, что система должна быть упрощена, и мы не должны использовать версии 0.x.
rofrol 23 сен. 2016, в 08:16
1

Вариант использования ранней разработки жизненного цикла и v0 имеет много смысла. Изучение правильного поведения v0 фактически заставило меня с нетерпением ждать других проектов на ранних этапах жизненного цикла. Это означает, что у вас может быть быстро изменяющийся API с множеством обратных несовместимостей без необходимости объявлять ваш проект как 1.x (иначе: стабильный), когда это действительно не так.
ProLoser 23 сен. 2016, в 17:26
0

Я понимаю это, но мне просто не нравится, как это работает с semver и квалификаторами
rofrol 23 сен. 2016, в 20:03
2

Это больше похоже на мнение и не должно восприниматься как общепринятый подход. И ^ 0.1.x получает патчи отлично.
ProLoser 11 окт. 2016, в 16:01
0

@ProLoser Но вы не получите ^0.1.x по умолчанию при установке из npm. Скорее всего, это будет ^0.1.3 который отменяет любые обновления. В любом случае, я отказался от рекомендации не использовать 0.* и просто добавил уведомление.
rofrol 30 апр. 2017, в 09:46
0

@TheBaj не стесняйтесь изменить ответ.
rofrol 14 июль 2017, в 14:35
0

@rofrol Я только что отредактировал ответ.
TheBaj 14 июль 2017, в 15:00

Показать ещё 6 комментариев

46

~: разумно закрыть до

   ~1.1.5: 1.1.0 <= accepted < 1.2.0

^: Совместимый с

   ^1.1.5: 1.1.5 <= accepted < 2.0.0

   ^0.1.3: 0.1.3 <= accepted < 0.2.0

   ^0.0.4: 0.0.4 <= accepted < 0.1.0

haotang 27 июнь 2014, в 17:18

8

^0.1.3: 0.1.3 <= accepted < 1.0.0 вместо, нет?
kytwb 04 нояб. 2014, в 08:11
16

@kytwb - нет. В специальном случае номеров версий нулевого выпуска карат эквивалентен тильде. Таким образом, ^0.1.3 принимает только версии 0.1.x и не принимает 0.2.0 , даже если это небольшое увеличение. Это поведение эквивалентно ~0.1.3 . Причиной такого поведения является то, что пакеты с нулевым выпуском все еще считаются нестабильными; по словам semver.org , # 4, «все может измениться в любое время» (включая несовместимые назад изменения).
chharvey 25 фев. 2015, в 20:45

26

^ - 1. [любой]. [любой] (последняя младшая версия)
~ - 1.2. [любой] (последний патч)

Отличное чтение это сообщение в блоге о том, как semver относится к npm
и что они делают, чтобы он соответствовал стандарту semver
http://blog.npmjs.org/post/98131109725/npm-2-0-0

Will Stern 15 дек. 2014, в 18:17

2

не соответствует действительности: диапазоны карет ^ 1.2.3 ^ 0.2.5 ^ 0.0.4. Позволяет вносить изменения, которые не изменяют крайнюю левую ненулевую цифру в кортеже [major, minor, patch]. Другими словами, это позволяет использовать исправления и незначительные обновления для версий 1.0.0 и выше, обновления исправлений для версий 0.X> = 0.1.0 и не обновлять версии 0.0.X. docs.npmjs.com/misc/semver#caret-ranges-1-2-3-0-2-5-0-0-4
rofrol 11 окт. 2015, в 16:07

23

Совпадение шляпы может считаться "сломанным", потому что оно не обновляет ^0.1.2 до 0.2.0. Когда программное обеспечение появляется, используйте версии 0.x.y, и соответствие шлям будет соответствовать только последней переменной (y). Это делается специально. Причина в том, что в то время как программное обеспечение развивается, API меняется быстро: однажды у вас есть эти методы, и на днях у вас есть эти методы, а старые исчезли. Если вы не хотите разорвать код для людей, которые уже используют вашу библиотеку, вы идете и увеличиваете основную версию: например. 1.0.0 → 2.0.0 → 3.0.0. Таким образом, к тому времени, когда ваше программное обеспечение, наконец, будет выполнено на 100% и полнофункционально, оно будет похоже на версию 11.0.0, и это не выглядит очень значимым и на самом деле выглядит запутанным. Если бы вы были, с другой стороны, используя версии 0.1.x → 0.2.x → 0.3.x, то к моменту завершения программного обеспечения на 100% и полнофункционального он будет выпущен как версия 1.0.0, и это означает "Этот выпуск является долгосрочным сервисом, вы можете продолжить и использовать эту версию библиотеки в своем производственном коде, и автор не изменит все завтра или в следующем месяце, и он не откажется от пакета".

Правило: используйте версию 0.x.y, когда ваше программное обеспечение еще не созрело и не выпустило его с увеличением средней цифры при изменении общедоступного API (поэтому люди, имеющие ^0.1.0, не получат обновление 0.2.0, и это не нарушит их код). Затем, когда программное обеспечение созреет, отпустите его под 1.0.0 и увеличивайте левую цифру каждый раз, когда изменится ваш открытый API (поэтому люди, имеющие ^1.0.0, не получат обновление 2.0.0 и не нарушат свой код).

Given a version number MAJOR.MINOR.PATCH, increment the:

MAJOR version when you make incompatible API changes,
MINOR version when you add functionality in a backwards-compatible manner, and
PATCH version when you make backwards-compatible bug fixes.

asdfasdfads 19 окт. 2015, в 12:42

0

Этот комментарий был до смешного полезен и, похоже, не очень хорошо задокументирован. У вас есть ссылка на документацию об этом поведении? Этот ответ о v0 проектах мне очень помог.
ProLoser 22 сен. 2016, в 19:15
0

У меня нет ссылки: я тоже нашел эту информацию, погуглив и поиграв с калькулятором семантической версии npm semver.npmjs.com
asdfasdfads 23 сен. 2016, в 12:01
2

Необходимо добавить к их документации более формальным способом. Я выступал в Sony с моей инженерной командой, потому что, кажется, ее так легко не заметить. slides.com/proloser/semver-v0
ProLoser 23 сен. 2016, в 17:27

Показать ещё 1 комментарий

11

Объяснение одного лайнера

Стандартная система управления версиями - major.minor.build(например, 2.4.1)

npm проверяет и исправляет версию конкретного пакета на основе этих символов

~: исправлена основная версия, исправлена незначительная версия, соответствует любому номеру сборки

например.: ~ 2.4.1 означает, что он будет проверять на 2.4.x, где x - это что-то

^: основная версия исправлена, соответствует любой второстепенной версии, соответствует любому номеру сборки

например.: ^ 2.4.1 означает, что он проверит 2.x.x, где x - что-то

Avinash 21 янв. 2017, в 08:02

2

Я вижу 7 строк в этом ответе
FluxLemur 03 апр. 2018, в 22:07

9

Возможно, вы видели тильду (~) и каретку (^) в package.json. В чем разница между ними?

Когда вы устанавливаете npm момент --save, он сохраняет запись в package.json с префиксом caret (^).

Тильда (~)

Проще говоря, тильда (~) соответствует самой последней младшей версии (среднее число). ~ 1.2.3 будет соответствовать всем версиям 1.2.x, но будет отсутствовать 1.3.0.

Каретка (^)

Каретка (^), с другой стороны, более расслабленная. Он обновит вас до самой последней основной версии (первый номер). ^ 1.2.3 будет соответствовать любому выпуску 1.xx, включая 1.3.0, но будет удерживаться на 2.0.0.

Ссылка: https://medium.com/@Hardy2151/caret-and-tilde-in-package-json-57f1cbbe347b

Abdou Sameh 26 нояб. 2017, в 19:37

0

Опять же, этот ответ вводит в заблуждение. SemVer четко заявляет, что нормальный номер версии ДОЛЖЕН принимать форму XYZ [где] X - основная версия, Y - вспомогательная версия, а Z - версия исправления.
Leo 28 фев. 2019, в 15:06

5

~ Тильда:

~ исправляет основные и второстепенные числа.
Он используется, когда вы готовы принять исправления ошибок в своей зависимости, но не хотят каких-либо потенциально несовместимых изменений.
Тильда соответствует последней второстепенной версии (среднее число).
~ 1.2.3 будет соответствовать всем версиям 1.2.x, но пропустит 1.3.0.
Tilde (~) дает вам исправления ошибок.

^ Caret:

^ исправляет только основное число.
Он используется, когда вы внимательно наблюдаете за своими зависимостями и готовы быстро изменить свой код, если незначительная версия будет несовместимой.
Он обновит вас до самой последней основной версии (первое число).
^ 1.2.3 будет соответствовать любому выпуску 1.x.x, включая 1.3.0, но он будет отключен на 2.0.0.
Caret (^) дает вам и обратно совместимую новую функциональность.

Laxmi 30 сен. 2016, в 11:01

0

Тильда соответствует самой последней версии патча (последний номер). Каретка соответствует самой последней вспомогательной версии (среднее число).
Abdul Rauf 30 март 2018, в 04:25
1

@AbdulRauf правильно. Ваше объяснение неверно
santanu bera 04 дек. 2018, в 13:47

3

Тильда (~)

исправлена основная версия, исправлена вспомогательная версия, соответствует любому номеру сборки

"express": "~4.13.3"

~4.13.3 означает, что он проверит 4.13.x, где x - это что-то, а 4.14.0

Карета (^)

исправлена основная версия, соответствует любой дополнительной версии, соответствует любому номеру сборки

"supertest": "^3.0.0"

^3.0.0 означает, что он проверит на 3.xx, где х что-нибудь

Farhan Yaseen 09 март 2018, в 12:42

0

Можете ли вы рассказать, чем этот ответ отличается от того же ответа, который был опубликован 4 года назад ?
Franklin Yu 06 нояб. 2018, в 19:31

1

Тильда ~ соответствует второстепенной версии, если вы установили пакет с 1.4.2, и после установки также доступны версии 1.4.3 и 1.4.4, если в вашем package.json он используется как ~ 1.4.2, а затем npm install В вашем проекте после обновления будет установлена версия 1.4.4. Но для этого пакета доступно 1.5.0, и он не будет установлен ~. Это называется минорной версией.

Знак ^ соответствует основной версии, если пакет 1.4.2 остановлен в вашем проекте и 1.5.0 также доступен, то ^ установит основную версию. Он не позволит установить 2.1.0, если у вас есть ^ 1.4.2.

Фиксированная версия, если вы не хотите менять версию пакета при каждой установке, тогда использовали фиксированную версию без какого-либо специального символа, например, "1.4.2"

Последняя версия * Если вы хотите установить последнюю версию, используйте только * перед именем пакета.

Mudassir 17 янв. 2019, в 11:55

1

Этот ответ вводит в заблуждение. SemVer четко заявляет, что нормальный номер версии ДОЛЖЕН принимать форму XYZ [где] X - основная версия, Y - вспомогательная версия, а Z - версия исправления.
Leo 28 фев. 2019, в 15:03

1

Номер версии в синтаксисе, который обозначает каждый раздел с различным значением. синтаксис разбит на три части, разделенные точкой.

major.minor.patch 1.0.2

Major, minor и patch представляют разные версии пакета.

npm использует тильду (~) и каретку (^), чтобы указать, какой патч и второстепенные версии использовать соответственно.

Так что, если вы видите ~ 1.0.2, это значит установить версию 1.0.2 или последнюю версию патча, такую как 1.0.4. Если вы видите ^ 1.0.2, это значит установить версию 1.0.2 или последнюю минорную версию или версию патча, такую как 1.1.0.

Rajashekhar Reddy 28 сен. 2018, в 07:15

0

Можете ли вы рассказать, чем этот ответ отличается от того же ответа, который был опубликован 4 года назад ?
Franklin Yu 06 нояб. 2018, в 19:33

0

~ спецификации для минорных выпусков версий ^ указывает на основные выпуски версий

Например, если версия пакета 4.5.2, при обновлении ~ 4.5.2 будет установлена последняя версия 4.5.x (МЕНЬШАЯ ВЕРСИЯ) ^ 4.5.2 установит последнюю версию 4.xx (ОСНОВНАЯ ВЕРСИЯ)

user2849063 04 май 2018, в 12:39

5

Можете ли вы рассказать, чем этот ответ отличается от того же ответа, который был опубликован 4 года назад ?
Franklin Yu 06 нояб. 2018, в 19:32

0

^: принять изменения версии меньше, чем Left Большинство версий без нуля (первая цифра с нулевым номером слева).

~: Принять изменения версии меньше, чем 2-й левый Большинство версий без нуля (второй номер нулевой версии слева). ИЛИ Если нет второй версии "Левая самая не-нулевая" , то версия "Принять версию" будет меньше, чем "Левая большая версия" .

Abhijeet 21 сен. 2016, в 04:22

Ещё вопросы

К вашему сведению, вы можете предотвратить префиксы или использовать пользовательские, выполнив: npm config set save-prefix='' . (Вставьте ~ в кавычки, если это то, что вы предпочитаете.) Я лично делаю это и упаковываю вещи в производство.
Все подробности о том, как работают тильда и карета, и различия: github.com/npm/node-semver#tilde-ranges-123-12-1
Этот инструмент отличный помощник для тестирования semver.npmjs.com
@fncomp просто хотел уточнить, правильно ли я понял ваш комментарий. Вы используете только определенные версии зависимостей в своем проекте? наша команда не решается обновить зависимости .. вы бы порекомендовали использовать конкретные версии или префикс '~' для зависимостей ..?
@fncomp, не могли бы вы рассказать, что вы имеете в виду, говоря: «Я лично это делаю и упаковываю вещи в производство». Спасибо!
Я использовал для удаления префикса, но с термоусадочной пленкой или блокировкой пакета это на самом деле не нужно. Смотрите: docs.npmjs.com/files/package-locks
Семантическое управление версиями в npm и узле
Также можно указать точный диапазон версий, например 1.2.0 || >=1.2.2 <1.3.0 : точно 1.2.0 или все от 1.2.2 до 1.3.0 (включительно), но не 1.2.1 или 1.3.1 и выше, а также не 1.1.x и ниже ,
@CoDEmanX почему 1.3.0 включен, если вы используете < ?
Мой плохой, он должен был прочитать <=1.3.0 .
@Venryx да, это так. Это будет любая версия> = 1.0.0 и <2.0.0
Более конкретная ссылка приведена выше -> docs.npmjs.com/files/package.json#dependencies
Как насчет ^ 0.2.5? из docs.npmjs.com/misc/semver#caret-ranges-1-2-3-0-2-5-0-0-4 : диапазоны карет ^ 1.2.3 ^ 0.2.5 ^ 0.0.4. Позволяет вносить изменения, которые не изменяют крайнюю левую ненулевую цифру в кортеже [major, minor, patch]. Другими словами, это позволяет использовать исправления и незначительные обновления для версий 1.0.0 и выше, обновления исправлений для версий 0.X> = 0.1.0 и не обновлять версии 0.0.X.
@rofrol любая версия до 1.0.0 считается нестабильной, и эти правила не применяются
Итак, ваше объяснение не завершено
@rofrol Да, иногда плохое опускание для читабельности, шансы иметь что-либо ниже 1.0.0 для зависимости в пакете json довольно низки. см. также принцип 20/80, это отличное правило для того, чтобы сосредоточиться на том, что важно
Смотри мой ответ. Как вы думаете? stackoverflow.com/questions/22343224/...
@pspi Наличие версий ниже 1.0.0 "маловероятно"? Из 60 у нас ~ 15, и большинство из них не совсем неизвестны.
@DaveNewton ой ... даже если версия выше 1.0.0, нет никаких гарантий, что проект следует за semver, хотя
Это ужасный дефолт. Если последующие пакеты не могут поддерживать достаточную дисциплину, чтобы не сломать вещи, я всегда хочу точную версию того, что я просил. Не что-то еще.
@pspi ваш ответ гораздо яснее, чем любые другие ответы здесь
не соответствует действительности: диапазоны карет ^ 1.2.3 ^ 0.2.5 ^ 0.0.4. Позволяет вносить изменения, которые не изменяют крайнюю левую ненулевую цифру в кортеже [major, minor, patch]. Другими словами, это позволяет использовать исправления и незначительные обновления для версий 1.0.0 и выше, обновления исправлений для версий 0.X> = 0.1.0 и не обновлять версии 0.0.X. docs.npmjs.com/misc/semver#caret-ranges-1-2-3-0-2-5-0-0-4
Этот ответ совершенно неверен (как и многие другие здесь). Ни один из них никогда не исправит главное число! Как сказал @rofrol, ^ просто оставляет самую левую ненулевую цифру без изменений. С другой стороны, ~ разрешает только обновления патчей, если указана младшая версия (например, ~ 1.2.3 или ~ 1.2), и разрешает второстепенные обновления, если младшая версия не указана (например, ~ 1).
@TheBaj Они означают «исправить» как «определить» («fixate»), а не «настроить», так что вы все согласны с тем, как обрабатывается основное число.
Говорить людям, чтобы они не запускали проекты с 0, потому что разработчики из библиотек и потребителей не понимают систему, это ужасное решение. Я думаю, что @asdfasdfads имеет гораздо лучшую информацию.
@ProLoser Я просто считаю, что система должна быть упрощена, и мы не должны использовать версии 0.x.
Вариант использования ранней разработки жизненного цикла и v0 имеет много смысла. Изучение правильного поведения v0 фактически заставило меня с нетерпением ждать других проектов на ранних этапах жизненного цикла. Это означает, что у вас может быть быстро изменяющийся API с множеством обратных несовместимостей без необходимости объявлять ваш проект как 1.x (иначе: стабильный), когда это действительно не так.
Я понимаю это, но мне просто не нравится, как это работает с semver и квалификаторами
Это больше похоже на мнение и не должно восприниматься как общепринятый подход. И ^ 0.1.x получает патчи отлично.
@ProLoser Но вы не получите ^0.1.x по умолчанию при установке из npm. Скорее всего, это будет ^0.1.3 который отменяет любые обновления. В любом случае, я отказался от рекомендации не использовать 0.* и просто добавил уведомление.
@TheBaj не стесняйтесь изменить ответ.
@rofrol Я только что отредактировал ответ.
@kytwb - нет. В специальном случае номеров версий нулевого выпуска карат эквивалентен тильде. Таким образом, ^0.1.3 принимает только версии 0.1.x и не принимает 0.2.0 , даже если это небольшое увеличение. Это поведение эквивалентно ~0.1.3 . Причиной такого поведения является то, что пакеты с нулевым выпуском все еще считаются нестабильными; по словам semver.org , # 4, «все может измениться в любое время» (включая несовместимые назад изменения).
не соответствует действительности: диапазоны карет ^ 1.2.3 ^ 0.2.5 ^ 0.0.4. Позволяет вносить изменения, которые не изменяют крайнюю левую ненулевую цифру в кортеже [major, minor, patch]. Другими словами, это позволяет использовать исправления и незначительные обновления для версий 1.0.0 и выше, обновления исправлений для версий 0.X> = 0.1.0 и не обновлять версии 0.0.X. docs.npmjs.com/misc/semver#caret-ranges-1-2-3-0-2-5-0-0-4
Этот комментарий был до смешного полезен и, похоже, не очень хорошо задокументирован. У вас есть ссылка на документацию об этом поведении? Этот ответ о v0 проектах мне очень помог.
У меня нет ссылки: я тоже нашел эту информацию, погуглив и поиграв с калькулятором семантической версии npm semver.npmjs.com
Необходимо добавить к их документации более формальным способом. Я выступал в Sony с моей инженерной командой, потому что, кажется, ее так легко не заметить. slides.com/proloser/semver-v0
Опять же, этот ответ вводит в заблуждение. SemVer четко заявляет, что нормальный номер версии ДОЛЖЕН принимать форму XYZ [где] X - основная версия, Y - вспомогательная версия, а Z - версия исправления.
Тильда соответствует самой последней версии патча (последний номер). Каретка соответствует самой последней вспомогательной версии (среднее число).
@AbdulRauf правильно. Ваше объяснение неверно
Можете ли вы рассказать, чем этот ответ отличается от того же ответа, который был опубликован 4 года назад ?
Этот ответ вводит в заблуждение. SemVer четко заявляет, что нормальный номер версии ДОЛЖЕН принимать форму XYZ [где] X - основная версия, Y - вспомогательная версия, а Z - версия исправления.
Можете ли вы рассказать, чем этот ответ отличается от того же ответа, который был опубликован 4 года назад ?

jgillich · Accepted Answer · 2014-03-12T08-50-00.000Z

2944

Лучший ответ

Проще говоря, тильда соответствует последней младшей версии (среднему числу). ~ 1.2.3 будет соответствовать всем версиям 1.2.x, но будет отсутствовать 1.3.0.

Каретка, с другой стороны, более расслабленная. Он обновит вас до самой последней основной версии (первый номер). ^ 1.2.3 будет соответствовать любому выпуску 1.xx, включая 1.3.0, но будет удерживаться на 2.0.0.

http://fredkschott.com/post/2014/02/npm-no-longer-defaults-to-tildes/

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

jgillich 12 март 2014, в 08:50

236

Публикация здесь, чтобы надеяться поймать людей, которые не совсем продумали это, но и ^, и ~ предполагают, что вы можете доверять второстепенным и точечным релизам из ваших зависимостей. Если вы публикуете библиотеку и хотите, чтобы другие люди доверяли вам, НЕ ПРИНИМАЙТЕ ВЗГЛЯД НА ЗАВИСИМОСТЬ DOWNSTREAM. Плохое снятие точки с вашей зависимости может вызвать цепную реакцию вверх по течению, и люди будут стучать в вашу дверь, когда все станет грушевидным. Это еще одна серьезная причина для использования npm shrinkwrap в вашем производственном коде.
tehfoo 09 фев. 2015, в 18:33
3

Вы также можете просто покончить со всей ерундой npm, добавив свои версии с помощью ^ или ~ . Установите это, если вы хотите иметь жесткий контроль над вашими версиями: npm config set save-prefix=''
kumar_harsh 08 июль 2015, в 06:11
248

Это вводит в заблуждение для ^ . Он говорит , что ^ обновит вас до самой последней основной версии, когда в действительности она обновляет вас на самую последнюю младшую версию. то есть: - ^ 1.2.3: => = 1.2.3 <2.0.0 - ^ 0.2.3: => = 0.2.3 <0.3.0 - ^ 0.0.3: => = 0.0.3 <0.0.4
prasanthv 31 июль 2015, в 19:51
5

@prasanthv прав: из docs.npmjs.com/misc/semver#caret-ranges-1-2-3-0-2-5-0-0-4 : диапазоны карет ^ 1.2.3 ^ 0.2.5 ^ 0.0 +0,4. Позволяет вносить изменения, которые не изменяют крайнюю левую ненулевую цифру в кортеже [major, minor, patch]. Другими словами, это позволяет использовать исправления и незначительные обновления для версий 1.0.0 и выше, обновления исправлений для версий 0.X> = 0.1.0 и не обновлять версии 0.0.X.
rofrol 11 окт. 2015, в 16:19
15

@jgillich в semver, когда вы используете 0.2.x , 2 не является major version . Вот почему docs.npmjs.com использовал конкретные слова: крайняя the left-most non-zero digit . А как насчет этого случая: ^ 0.0.4 означает 0.0.4
rofrol 12 окт. 2015, в 10:14
0

Согласование Hat нарушается , потому что она не будет обновление ^0.1.2 до 0.2.0 . Правило: всегда 0.xx версию вашего пакета, пропуская 0.xx версий 0.xx и вы получите согласованное поведение
asdfasdfads 19 окт. 2015, в 11:29
7

@FagnerBrack: приведенный вами конкретный пример верен, но в целом ваш образ мышления неверен. Пример: допустим , у вас есть пакет A в 3 -х версиях: 0.0.1 , 0.0.2 и 0.0.3 . Существует ошибка в 0.0.1 , так что вы хотите иметь , по крайней мере 0.0.2 в вашем пакете B . Если вы напишите 0.0.x вы получите 0.0.3 , что нормально. Но если какой-то другой пакет C требует и B и A и дополнительно имеет ограничение "A": "<0.0.2" вы получите 0.0.1 без каких-либо проблем с конфликтом, а это не то, что вам нужно. Использование тильды ~0.0.2 должно помочь вам избежать этой проблемы.
Maciej Sz 22 окт. 2015, в 14:22
0

@MaciejSz Извините, но я не поняла. Вы говорите, что поведение для 0.0.x отличается от поведения ~0.0.0 или что поведение 0.x.0 отличается от поведения ^0.0.0 ? Или вы утверждаете, что 0.x.0 / ^0.0.0 лучше, чем 0.0.x / ~0.0.0 в предоставленном вами контексте?
Fagner Brack 22 окт. 2015, в 19:30
4

@FagnerBrack: я говорю, что при использовании тильды вы можете определить минимальный номер версии (по меньшей мере значащий номер версии). С нотацией 0.0.x вас нет этой опции, потому что любой наименее значимый номер версии будет действительным.
Maciej Sz 26 окт. 2015, в 12:22
0

@MaciejSz Теперь я понимаю, что указание минимальной версии вместо последней буквы «x» действительно допустимый вариант использования. Очень хороший момент. Хотя я бы порекомендовал использовать ни «x», ни «~» для обеспечения согласованности между несколькими разработчиками.
Fagner Brack 26 окт. 2015, в 16:26
0

Теперь у вас есть * которые обновляются до последнего обновления независимо от версии.
Matias 21 июль 2016, в 19:30
0

@haxpor Или используйте npm-check-updates от npm.
jgillich 23 фев. 2017, в 16:16
1

Стоит отметить, что вы можете использовать npm semver для вычисления диапазонов версий для конкретного пакета.
Wildhoney 06 март 2017, в 08:21
26

Странно, что этот неправильный ответ It will update you to the most recent major version с 2k + upvotes. Интересно, сколько людей сейчас думают, что ^ обновляет основную версию !! Нет никакой двусмысленности в отношении значения major / minor / patch при управлении версиями в semserv - это просто неправильно
Drenai 13 фев. 2018, в 20:51
3

Керет подходит к последнему Младшему, а не к майору. Это Major , Minor , Patch , Hotfix .
adi518 28 фев. 2018, в 16:47
0

В pre-5.x npm символы ( ~ / ^ ) влияли на загруженные зависимости во время npm install . После 5.x это предотвращает существование package-lock.json рядом с package.json . Для обновления зависимостей проекта, основанных на правилах, описанных в этом посте, можно использовать npm update (который также обновляет package-lock.json ) с последующей фиксацией обоих package.json и package-lock.json .
Marinos An 14 май 2018, в 10:58
0

Это не верно. Как указано выше, ^ указывает на обновление до второстепенных версий и исправлений (средний и последний номер), а & ~ указывает на обновление только до выпусков исправлений (последний номер). «Major» - это первое число в семантическом версионировании, указывающее критические изменения, которые вы не хотите автоматически обновлять. Никогда не видел такого откровенно неправильного ответа с таким высоким голосом. Это немного касается.
Peter Out 12 июнь 2018, в 19:19
2

Я отредактировал этот ответ, чтобы исправить объяснение. Вместо того, чтобы жаловаться на неправильный ответ в его комментариях, пожалуйста, сделайте что-нибудь об этом в следующий раз!
Ian Kemp 31 авг. 2018, в 09:58
0

Каретка НЕ будет обновляться до последней основной версии. Только минорная и патч версия.
Remi Sture 15 сен. 2018, в 06:48
0

Этот ответ не спасает, потому что он сформирован вокруг цитирования глупости. Ответ от pspi является правильным и должен быть поставлен на голосование. Терминология не вводит в заблуждение. Это ерунда. Если вы называете собаку лошадью, а затем говорите, что лошади едят мясо и кору, вы не говорите что-то, что вводит в заблуждение.
9ilsdx 9rvj 0lo 25 сен. 2018, в 10:02
1

У нас есть проблема, ребята ... ПОЧЕМУ это имеет 2764 голосов за, если это вводит в заблуждение или неправильно? Может быть, не нажимайте кнопку «вверх», если вы не уверены на 100% в том, за что голосуете. Йен, убери его на ступеньку ниже ... если ответ неправильный, вводит в заблуждение или вводит в заблуждение ... тогда он заслуживает обсуждения, вместо того, чтобы переходить все пальцы друг друга по ссылке редактирования.
Chad 24 окт. 2018, в 18:23

Показать ещё 19 комментариев