CLI команды

Volta предоставляет богатый набор команд командной строки для помощи в управлении вашим JavaScript инструментарием.

Основные команды

volta install

Устанавливает инструменты в ваш инструментарий.

# Установить последнюю LTS версию Node.js
volta install node

# Установить конкретную версию Node.js
volta install node@16.14.2

# Установить последнюю версию npm
volta install npm

# Установить конкретную версию yarn
volta install yarn@1.22.19

# Установить пакет глобально
volta install typescript
volta install @vue/cli

Опции:

• --verbose: Включить подробную диагностику
• --quiet: Предотвратить ненужный вывод

volta uninstall

Удаляет инструменты из вашего инструментария.

# Удалить Node.js
volta uninstall node

# Удалить npm
volta uninstall npm

# Удалить пакет
volta uninstall typescript

volta pin

Закрепляет инструменты в package.json вашего проекта.

# Закрепить Node.js
volta pin node@16.14.2

# Закрепить npm
volta pin npm@8.5.0

volta list

Показывает доступные инструменты в вашем инструментарии.

# Показать все инструменты
volta list all

# Показать установленные версии Node.js
volta list node

# Показать установленные пакетные менеджеры
volta list npm
volta list yarn

# Показать установленные пакеты
volta list packages

volta which

Показывает путь к указанному инструменту, который будет использовать Volta.

volta which node
volta which npm
volta which typescript

volta run

Запускает команды с пользовательскими версиями инструментов.

# Запустить с конкретной версией Node.js
volta run --node 14 node index.js

# Запустить с конкретной версией npm
volta run --npm 6 npm install

# Использовать как пользовательский Node.js, так и npm
volta run --node 14 --npm 6 npm install

Дополнительные команды

volta completions

Генерирует скрипты автодополнения для shell.

# Генерировать bash автодополнение
volta completions bash > volta.bash

# Генерировать zsh автодополнение
volta completions zsh > _volta

# Генерировать fish автодополнение
volta completions fish > volta.fish

volta setup

Настраивает Volta в вашей среде.

# Настроить Volta с настройками по умолчанию
volta setup

# Настроить volta без изменения файлов конфигурации
VOLTA_SKIP_SETUP=1 volta setup

volta help

Показывает справку для команд Volta.

# Общая справка
volta help

# Справка для конкретной команды
volta help install
volta help pin

Коды завершения

Команды Volta возвращают следующие коды завершения:

• 0: Успех
• 1: Общая ошибка
• 2: Ошибка аргументов командной строки
• Более высокие числа: Ошибки, специфичные для команды

Переменные окружения

Эти переменные окружения влияют на поведение Volta при выполнении команд:

• VOLTA_HOME: Директория, где Volta хранит данные
• VOLTA_LOGLEVEL: Уровень детализации журнала (error, warn, info, verbose, debug)
• VOLTA_SKIP_SETUP: Пропустить изменение файлов конфигурации shell во время настройки
• VOLTA_FEATURE_PNPM: Включить поддержку pnpm