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

Released under the BSD 2-Clause License.