Skip to content

Commandes CLI

Volta fournit un riche ensemble de commandes en ligne de commande pour vous aider à gérer votre chaîne d'outils JavaScript.

Commandes principales

volta install

Installe des outils dans votre chaîne d'outils.

bash
# Installer la dernière version LTS de Node.js
volta install node

# Installer une version spécifique de Node.js
volta install node@16.14.2

# Installer la dernière version de npm
volta install npm

# Installer une version spécifique de yarn
volta install yarn@1.22.19

# Installer des paquets globalement
volta install typescript
volta install @vue/cli

Options :

  • --verbose : Active les diagnostics détaillés
  • --quiet : Empêche les sorties inutiles

volta uninstall

Désinstalle des outils de votre chaîne d'outils.

bash
# Désinstaller Node.js
volta uninstall node

# Désinstaller npm
volta uninstall npm

# Désinstaller des paquets
volta uninstall typescript

volta pin

Épingle des outils au package.json de votre projet.

bash
# Épingler Node.js
volta pin node@16.14.2

# Épingler npm
volta pin npm@8.5.0

volta list

Liste les outils disponibles dans votre chaîne d'outils.

bash
# Lister tous les outils
volta list all

# Lister les versions Node.js installées
volta list node

# Lister les gestionnaires de paquets installés
volta list npm
volta list yarn

# Lister les paquets installés
volta list packages

volta which

Affiche le chemin de l'outil spécifié que Volta utilisera.

bash
volta which node
volta which npm
volta which typescript

volta run

Exécute des commandes avec des versions d'outils personnalisées.

bash
# Exécuter avec une version spécifique de Node.js
volta run --node 14 node index.js

# Exécuter avec une version spécifique de npm
volta run --npm 6 npm install

# Utiliser à la fois Node.js et npm personnalisés
volta run --node 14 --npm 6 npm install

Commandes supplémentaires

volta completions

Génère des scripts de complétion shell.

bash
# Générer des complétions bash
volta completions bash > volta.bash

# Générer des complétions zsh
volta completions zsh > _volta

# Générer des complétions fish
volta completions fish > volta.fish

volta setup

Configure Volta dans votre environnement.

bash
# Configurer Volta avec les paramètres par défaut
volta setup

# Configurer volta sans modifier les fichiers de profil
VOLTA_SKIP_SETUP=1 volta setup

volta help

Affiche l'aide pour les commandes Volta.

bash
# Aide générale
volta help

# Aide pour une commande spécifique
volta help install
volta help pin

Codes de sortie

Les commandes Volta retournent les codes de sortie suivants :

  • 0 : Succès
  • 1 : Erreur générale
  • 2 : Erreur d'arguments de ligne de commande
  • Nombres plus élevés : Erreurs spécifiques aux commandes

Variables d'environnement

Ces variables d'environnement affectent le comportement de Volta lors de l'exécution des commandes :

  • VOLTA_HOME : Le répertoire où Volta stocke ses données
  • VOLTA_LOGLEVEL : Le niveau de détail des logs (error, warn, info, verbose, debug)
  • VOLTA_SKIP_SETUP : Ignorer la modification des fichiers de profil shell pendant la configuration
  • VOLTA_FEATURE_PNPM : Activer le support pnpm