Skip to content

volta setup

La commande volta setup active Volta en modifiant le PATH de l'utilisateur actuel (de manière spécifique à la plateforme) pour inclure le répertoire des shims Volta. Elle a la syntaxe suivante :

bash
Active Volta pour l'utilisateur actuel

Usage :
    volta setup [FLAGS]

Drapeaux :
        --verbose    Active les diagnostics détaillés
        --quiet      Empêche les sorties inutiles
    -h, --help       Affiche les informations d'aide

Configuration Unix

Sur les systèmes Unix (macOS et Linux), volta setup recherche les scripts de fichiers de configuration en utilisant la liste suivante :

  • ~/.profile
  • ~/.bash_profile
  • ~/.bashrc
  • ~/.zshrc
  • ~/.config/fish/config.fish
  • La valeur de la variable d'environnement PROFILE

Pour les fichiers existants, volta setup les modifiera pour inclure les lignes suivantes :

  1. Définir la variable d'environnement VOLTA_HOME (généralement définie à ~/.volta)
  2. Ajouter $VOLTA_HOME/bin à la variable d'environnement PATH

Si le fichier de configuration de votre shell actuel (détecté en utilisant la variable d'environnement $SHELL) n'existe pas, il sera créé avec le contenu approprié si possible.

Configuration Windows

Sur Windows, volta setup modifiera la variable d'environnement utilisateur Path pour inclure le répertoire des shims (%LOCALAPPDATA%\Volta\bin). Cela garantit que les commandes Volta sont disponibles dans toutes les invites de commande.

Exemples

Configuration de base

bash
# Exécuter le processus de configuration
volta setup

Cela mettra à jour vos fichiers de configuration shell et rendra Volta disponible dans votre shell.

Configuration silencieuse

bash
# Exécuter la configuration avec une sortie minimale
volta setup --quiet

Quand l'utiliser

La commande volta setup est utile dans plusieurs situations :

  1. Après une nouvelle installation : Exécuter après avoir installé Volta pour la première fois
  2. Après suppression de la configuration shell : Si vous avez modifié manuellement vos fichiers de configuration shell et supprimé la configuration de Volta
  3. Nouvel utilisateur : Lors de la configuration de Volta pour un nouvel utilisateur sur le système
  4. Après changement de shell : Si vous avez basculé vers un shell différent

Ce que la configuration ajoute à vos fichiers de configuration

Pour bash/zsh/sh, volta setup ajoute des lignes similaires à :

bash
export VOLTA_HOME="$HOME/.volta"
export PATH="$VOLTA_HOME/bin:$PATH"

Pour le shell fish, il ajoute :

fish
set -gx VOLTA_HOME "$HOME/.volta"
set -gx PATH "$VOLTA_HOME/bin" $PATH

Configuration manuelle

Si vous ne souhaitez pas utiliser volta setup, vous pouvez ajouter manuellement Volta à votre PATH :

  1. Créer le répertoire home de Volta (par défaut ~/.volta sur Unix, %LOCALAPPDATA%\Volta sur Windows)
  2. Ajouter le répertoire bin à votre variable d'environnement PATH
  3. Recharger votre shell ou redémarrer votre terminal

Dépannage

Si Volta n'est pas disponible après avoir exécuté volta setup :

  1. Assurez-vous d'avoir ouvert une nouvelle fenêtre de terminal
  2. Vérifiez que le répertoire bin de Volta est dans votre PATH (utilisez echo $PATH sur Unix, echo %PATH% sur Windows)
  3. Vérifiez que le répertoire home de Volta existe
  4. Pour les systèmes Unix, vérifiez que vos fichiers de configuration shell ont été correctement modifiés