Contactez-nous

Comment installer Ruby avec un gestionnaire de version (rbenv)

Suivez notre guide pas à pas pour installer Ruby proprement avec le gestionnaire de version rbenv. Découvrez pourquoi c'est la méthode professionnelle pour éviter les conflits et gérer plusieurs projets. Essentiel pour votre carrière de développeur Ruby.

Pourquoi utiliser un gestionnaire de version comme rbenv ?

Vous pourriez être tenté d'installer Ruby directement via le gestionnaire de paquets de votre système d'exploitation. C'est une erreur fréquente chez les débutants, qui mène souvent à des problèmes de permissions et à des conflits de versions. Dans le monde professionnel, un même développeur travaille souvent sur plusieurs projets qui ne requièrent pas la même version de Ruby. Un projet hérité pourrait nécessiter une ancienne version (ex: 2.7.5) tandis qu'un nouveau projet utilisera la dernière version stable (ex: 3.2.2).

C'est ici qu'intervient un gestionnaire de version comme rbenv. Son rôle est de vous permettre d'installer plusieurs versions de Ruby sur votre machine et de basculer de l'une à l'autre très simplement, par projet ou même globalement. Il agit comme un aiguilleur qui s'assure que lorsque vous tapez la commande ruby, votre système exécute la bonne version.

Conseil de pro : Nous choisissons rbenv car il est léger et non intrusif. Contrairement à d'autres outils, il ne modifie pas directement vos commandes shell. Il fonctionne en ajoutant simplement un répertoire au début de votre $PATH, une approche propre et facile à déboguer. C'est la méthode privilégiée par de nombreux professionnels de la communauté Ruby.

Etape 1 : Installer rbenv et ruby-build

L'installation de rbenv se fait en deux temps : on installe d'abord l'outil rbenv lui-même, puis un plugin nommé ruby-build qui, comme son nom l'indique, est responsable de la compilation et de l'installation des différentes versions de Ruby. La procédure varie légèrement selon votre système d'exploitation.

Sur macOS (avec Homebrew) : C'est la méthode la plus simple si vous êtes sur Mac. Ouvrez votre terminal et lancez la commande suivante :
brew install rbenv ruby-build
Sur Linux (Debian, Ubuntu) : Vous pouvez utiliser votre gestionnaire de paquets. La commande exacte peut varier, mais elle ressemblera à ceci :
sudo apt update
sudo apt install rbenv
Pour Windows : L'approche moderne et recommandée est d'utiliser le Sous-système Windows pour Linux (WSL). Une fois que vous avez installé une distribution Linux comme Ubuntu depuis le Microsoft Store et que vous êtes dans votre terminal WSL, suivez simplement les instructions pour Linux ci-dessus.

Etape 2 : Configurer rbenv dans votre shell

Une fois installé, rbenv doit être initialisé à chaque ouverture de votre terminal. C'est une étape cruciale et souvent oubliée. Lancez d'abord la commande rbenv init. Elle vous indiquera la ligne exacte à ajouter à votre fichier de configuration de shell.

Cette ligne doit être ajoutée à la fin de votre fichier de configuration, qui est généralement ~/.zshrc (pour Zsh, le défaut sur les macOS récents) ou ~/.bash_profile (pour Bash). Par exemple, pour Zsh :

echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc

Après avoir modifié ce fichier, vous devez fermer et rouvrir votre terminal pour que les changements prennent effet. C'est indispensable. Si vous sautez cette étape, votre système ne saura pas comment utiliser rbenv et continuera d'utiliser la version système de Ruby (ou aucune).

Etape 3 : Installer une version de Ruby et l'activer

Maintenant que rbenv est prêt, nous pouvons lui demander d'installer la version de Ruby que nous souhaitons. Pour voir la liste de toutes les versions disponibles, vous pouvez taper rbenv install -l. Installons une version récente et stable (la version exacte peut changer, mais le processus reste le même) :

rbenv install 3.2.2
Attention : Cette commande peut prendre plusieurs minutes. rbenv est en train de télécharger le code source de Ruby et de le compiler spécifiquement pour votre machine. C'est normal, soyez patient !

Une fois l'installation terminée, il faut dire à rbenv d'utiliser cette version. La meilleure pratique est de la définir comme votre version globale par défaut pour le moment :

rbenv global 3.2.2

Vous disposez maintenant d'un environnement de développement Ruby propre, moderne et professionnel. Dans la section suivante, nous verrons comment vérifier que tout fonctionne comme prévu.