Поддержка pnpm

Поддержка pnpm в настоящее время является экспериментальной. Чтобы включить её, убедитесь, что переменная окружения VOLTA_FEATURE_PNPM установлена в 1. В Windows её можно добавить в пользовательские или системные переменные окружения в настройках системы. В Linux/Mac вы можете установить это значение в вашем файле конфигурации скрипта (например, .bash_profile, .zshrc или подобном).

Поскольку эта поддержка является экспериментальной, могут быть некоторые нерешённые проблемы. Ниже перечислены некоторые известные ограничения, но если вы столкнётесь с чем-то, что не работает как ожидается при использовании pnpm с Volta, пожалуйста, создайте issue в нашем GitHub.

Известные ограничения

Глобальные установки

В настоящее время глобальные установки (например, pnpm install -g) не поддерживаются и приведут к ошибке.

Миграция

В настоящее время нет автоматической миграции, поэтому если вы ранее установили pnpm как глобальный пакет Volta, вам нужно будет вручную переустановить его, вызвав volta install pnpm. Вы можете удалить ранее установленный пакет pnpm с помощью volta uninstall pnpm перед включением поддержки и переустановкой. После переключения на нативную поддержку pnpm вы не сможете удалить изолированный старый пакет pnpm, вызвав ту же команду из-за отсутствия реализации удаления в настоящее время.

Включение поддержки pnpm

В Unix (Linux/macOS)

Добавьте следующую строку в ваш файл конфигурации shell (.bashrc, .zshrc и т.д.):

export VOLTA_FEATURE_PNPM=1

Затем перезагрузите ваш shell или выполните:

source ~/.bashrc  # или ваш конкретный файл конфигурации

В Windows

1. Откройте меню "Пуск" и найдите "переменные окружения"
2. Нажмите "Изменить переменные окружения системы"
3. В окне "Свойства системы" нажмите "Переменные окружения"
4. Под "Переменные пользователя" нажмите "Создать"
5. Введите "VOLTA_FEATURE_PNPM" как имя переменной и "1" как значение
6. Нажмите "ОК", чтобы закрыть все диалоги

Использование Volta с pnpm

После включения поддержки pnpm вы можете:

1. Установить pnpm как ваш пакетный менеджер по умолчанию:

volta install pnpm

2. Закрепить конкретную версию pnpm в проекте:

volta pin pnpm@7.14.0

3. Просмотреть установленные версии pnpm:

volta list pnpm

Устранение неполадок

Если вы столкнулись с проблемами pnpm в Volta:

1. Убедитесь, что флаг функции установлен правильно:

   • В Unix: echo $VOLTA_FEATURE_PNPM
   • В Windows: echo %VOLTA_FEATURE_PNPM%

2. Проверьте, что pnpm установлен правильно:

   • Выполните volta list, чтобы увидеть, появляется ли pnpm в списке

3. Для любых других проблем, пожалуйста, сообщите о них в репозитории Volta GitHub.