Comprendre Volta

Comment Volta fonctionne

Volta gère vos outils en ligne de commande JavaScript en créant des shims qui routent vers la bonne version basée sur votre répertoire actuel. Cela permet à différents projets d'utiliser différentes versions des mêmes outils sans aucune configuration supplémentaire.

Système de shims

Quand vous installez Volta, il ajoute un ensemble de petits shims à votre PATH :

• Un shim pour node
• Un shim pour chaque gestionnaire de paquets (npm, yarn, pnpm, etc.)
• Un shim pour chaque paquet global que vous installez

Ces shims sont de minuscules exécutables qui déterminent la version réelle de l'outil à exécuter en :

1. Vérifiant si vous êtes dans un projet avec des versions d'outils épinglées
2. Utilisant vos versions par défaut si aucune version spécifique au projet n'est trouvée

Versions spécifiques au projet

Volta stocke les exigences d'outils de projet dans la section volta de votre fichier package.json :

{
  "volta": {
    "node": "16.15.1",
    "npm": "8.11.0"
  }
}

Quand vous exécutez des commandes dans un répertoire avec cette configuration, Volta s'assure automatiquement que vous utilisez ces versions exactes.

Versions par défaut

Pour les emplacements en dehors des projets sans versions épinglées, Volta utilise vos outils par défaut. Vous pouvez les configurer avec :

volta install node@16.15.1
volta install npm@8.11.0

Pourquoi Volta ?

Environnements cohérents

Volta garantit que tous ceux qui travaillent sur un projet utilisent exactement la même chaîne d'outils, éliminant les problèmes "ça marche sur ma machine".

Zéro overhead

Contrairement à d'autres gestionnaires de version, Volta ne nécessite pas de commandes supplémentaires pour changer de version quand vous changez de projet. Cela se passe automatiquement quand vous naviguez dans votre système de fichiers.

Performance rapide

Construit avec Rust, Volta est conçu pour la vitesse. Son architecture de shims signifie un overhead minimal lors de l'exécution d'outils JavaScript.

Intégration transparente

Volta fonctionne avec vos flux de travail de développement JavaScript existants sans changer vos habitudes ou processus.

Flux de travail courants

Démarrer un nouveau projet

# Créer le répertoire et configurer le paquet
mkdir my-project && cd my-project
npm init -y

# Épingler les versions Node.js et npm
volta pin node@16
volta pin npm@8

# Installer les dépendances
npm install express

Contribuer à un projet existant

# Cloner le dépôt
git clone https://github.com/example/project.git
cd project

# Si le projet a une configuration volta dans package.json,
# les bons outils seront utilisés automatiquement

# S'il n'en a pas, vous pouvez les ajouter
volta pin node@14

Installer des outils globaux

# Installer un paquet global
volta install typescript

# Maintenant vous pouvez l'utiliser depuis n'importe où
tsc --version