- Il existe plusieurs façons d'installer Ruby sur Windows, RubyInstaller étant l'option la plus simple et la plus complète.
- La configuration correcte de votre environnement (Node.js, Yarn, SQLite et DevKit) est essentielle pour éviter les problèmes lors de l'installation de gemmes ou de frameworks comme Rails.
- La gestion des versions et des dépendances est essentielle pour travailler sur plusieurs projets et éviter les conflits entre les installations.
Voulez-vous commencer avec Ruby sur votre PC Windows Vous ne savez toujours pas par où commencer ? Pas d'inquiétude, ce n'est pas compliqué si vous suivez un guide clair qui explique chaque étape et évite les problèmes les plus courants. De plus, si vous avez lu plusieurs tutoriels et constaté que chacun aborde le processus différemment (ou laisse des points importants flous), vous trouverez ici une solution. explication complète et sans technicité compliquée, il rassemble toutes les informations pertinentes disponibles et vous les présente de manière simple, organisée et à jour.
Nous allons vous expliquer tout ce que vous devez savoir pour installer Ruby sur Windows, que vous programmiez vos propres scripts, développiez avec des frameworks comme Ruby on Rails ou appreniez simplement le langage de A à Z. Soyez attentifs, car nous vous donnerons également des conseils utiles pour éviter les erreurs courantes et optimiser votre environnement de développement dès le départ.
Pourquoi installer Ruby sur Windows et quelles options sont disponibles ?
Ruby est un langage de programmation programmation polyvalent et facile à apprendre, idéal pour ceux qui débutent en programmation comme pour les professionnels à la recherche d'un outil puissant et flexible. Bien qu'il soit plus courant dans les systèmes Linux ou macOS, de plus en plus de développeurs optent pour Windows, notamment avec des outils comme RubyInstaller qui simplifient le processus.
À travers RubyInstallerInstaller Ruby sur Windows est plus simple que jamais, car il inclut tout le nécessaire pour démarrer immédiatement. D'autres méthodes sont également disponibles pour ceux qui souhaitent gérer plusieurs versions de Ruby ou personnaliser l'installation pour des projets spécifiques, comme les gestionnaires de versions. commandes et la compilation manuelle du code source.
L'un des plus grands avantages de l'utilisation RubyInstaller c'est qu'il intègre l'environnement MSYS2, ce qui facilite l'installation de gemmes et de dépendances natives, permettant de travailler sur des projets complexes tels que Ruby sur Rails sans complications supplémentaires.
Outils et prérequis
Avant de commencer l'installation de Ruby, il est judicieux d'avoir quelques outils de base sur votre ordinateur :
- Git : Très utile pour gérer vos projets et télécharger du code source à partir de référentiels en ligne comme GitHub.
- Éditeur de texte: Atom, VS Code ou Sublime Text sont de bonnes options pour éditer du code Ruby.
- Node.js et Yarn : Nécessaire si vous envisagez de travailler avec Ruby on Rails ou des outils modernes de l'écosystème JavaScript.
- SQLite : Recommandé si vous démarrez des projets Rails, car il s'agit généralement du système de base de données par défaut.
Ne vous inquiétez pas si vous ne possédez pas encore l'un de ces éléments, car nous allons voir ci-dessous comment les installer et les configurer facilement.
Étape 1 : Installation de Git sous Windows
Git est essentiel pour tout développeur moderne. Pour l'installer sous Windows, rendez-vous simplement sur le site officiel de Git (https://git-scm.com/download/win), téléchargez le programme d'installation correspondant à votre système (généralement 64 bits) et suivez l'assistant. Pendant l'installation, vous pouvez conserver les options par défaut en choisissant Git bash comme un émulateur de terminal. Lorsque vous avez terminé, vous pouvez ouvrir Git Bash et vérifier si tout fonctionne correctement en exécutant la commande git-version.
Étape 2 : Téléchargement et utilisation de RubyInstaller
La méthode la plus recommandée et la plus courante pour installer Ruby sur Windows est via RubyInstaller, un outil officiel qui intègre à la fois l'interpréteur et les composants essentiels au développement.
Pour obtenir la dernière version :
- Accédez au site Web officiel de RubyInstaller : https://rubyinstaller.org/
- Téléchargez le programme d'installation le plus récent, en recherchant la variante qui inclut Kit de développement. Exemple : « Ruby+Devkit 3.xx (x64) ».
- Exécutez le programme d'installation, acceptez le contrat de licence et sélectionnez l'option permettant d'ajouter Ruby à votre variable PATH Windows. Cela facilitera l'utilisation de Ruby depuis n'importe quel terminal.
- Dans la dernière étape, assurez-vous de laisser l'option sélectionnée pour Installer MSYS2 et les outils de développement nécessaires. Lorsque vous avez terminé, un terminal s'ouvrira et exécutera la configuration automatique de MSYS2 avec plusieurs options ; l'option 3 couvre généralement tous les paramètres nécessaires pour la plupart des utilisateurs.
Pour vérifier que Ruby a été correctement installé, ouvrez Git Bash ou n'importe quel terminal et exécutez ruby -vSi tout s'est bien passé, vous verrez la version installée sur l'écran.
Étape 3 : Installation de Ruby DevKit et configuration de l'environnement
El DevKit Il est essentiel pour compiler certains gems nécessitant des composants natifs. Si vous avez installé Ruby avec le package +Devkit, vous disposez généralement déjà de tout le nécessaire. Cependant, si vous devez l'installer manuellement :
- Téléchargez le package DevKit depuis le site Web RubyInstaller.
- Exécutez le programme d’installation et extrayez les fichiers dans un dossier, par exemple « C:\DevKit ».
- Ouvrir une fenêtre de commande (cmd.exe), accédez au dossier DevKit et exécutez :
> chdir C:\DevKit > ruby dk.rb init > ruby dk.rb install
Étape 4 : Installation et configuration de composants supplémentaires (Node.js, Yarn et SQLite)
Lorsque vous envisagez de créer des projets Web avec Ruby on Rails, vous aurez également besoin Node.js y fil pour gérer les ressources JavaScript, ainsi que SQLite si vous utilisez la configuration Rails par défaut.
- Node.js : Aller à nodejs.orgTéléchargez la version LTS recommandée et suivez les étapes. Lors de l'installation, assurez-vous de sélectionner l'option permettant d'installer des outils supplémentaires si vous y êtes invité.
- Fil: Téléchargez le programme d'installation à partir de Site officiel de Yarn et suivez les étapes à l'écran.
- SQLite : Téléchargez les fichiers sqlite-dll-win64-x64-XXXXXX.zip y sqlite-tools-win32-x86-XXXXXX.zip depuis le site officiel, décompressez son contenu dans le dossier C: \ Windows \ System32 afin qu'ils soient accessibles en tant que commandes globales.
Confirmez que tout va bien en exécutant les commandes dans le terminal noeud -v, fil -v y sqlite3 –versionVous devriez voir les versions installées sans aucun problème.
Étape 5 : Vérification de l’installation de Ruby
Pour vous assurer que Ruby est pleinement opérationnel, ouvrez un terminal et tapez :
ruby -v
Vous devriez voir la version installée. Vous pouvez également tester l'installation du gem, par exemple avec :
bundler d'installation de gem
Si tout se passe bien, votre environnement est prêt à fonctionner. Si vous recevez des messages d'erreur, vérifiez que vous avez ajouté Ruby à votre variable PATH et terminé l'installation de MSYS2.
Étape 6 : Installation de Rails et de vos premiers gemmes
L'étape habituelle suivante consiste à installer Rails, le framework le plus emblématique de l'écosystème Ruby. Pour cela, exécutez simplement la commande suivante dans le terminal :
Gem installer des rails
L'installation peut prendre plusieurs minutes, car de nombreuses dépendances sont téléchargées et compilées. Une fois l'installation terminée, vérifiez-la avec :
rails -v
En plus de Rails, il est fortement recommandé d'installer Bundler (bien qu'il soit généralement installé automatiquement). Bundler est le joyau responsable de la gestion du reste des dépendances de vos projets Ruby :
bundler d'installation de gem
Créer et démarrer votre premier projet Ruby on Rails
Si vous souhaitez aller plus loin et vérifier que tout fonctionne correctement, vous pouvez créer votre premier projet Rails :
rails nouvelle my_test_app
Une fois le processus terminé, accédez au nouveau répertoire et démarrez le serveur :
cd mon_test_app serveur Rails
Ouvrez votre navigateur et accédez à http://localhost:3000Vous devriez voir l'écran de bienvenue de Rails, ce qui signifie que Ruby et tous les composants sont correctement installés et configurés sur votre ordinateur Windows.
N'oubliez pas que vous pouvez fermer le serveur en appuyant sur Ctrl + C Dans le terminal.
Gestionnaires de versions : comment gérer plusieurs installations Ruby
Si vous devez travailler sur différents projets avec différentes exigences de version Ruby (par exemple, une ancienne application et une nouvelle application créée), il existe des gestionnaires de versions spécifiques pour Windows, tels que rbenv pour Windows (adapté à PowerShell) O uru, qui permettent de basculer facilement entre les versions et sont conçus pour s'intégrer de manière native.
D'autres managers très populaires tels que asdf-vm y grassouillet Ils ont tendance à se concentrer davantage sur les environnements UNIX, mais si vous avez de l'expérience, vous pouvez également les utiliser sous Windows avec certaines adaptations.
Installation et compilation manuelles de Ruby à partir des sources
Dans la plupart des cas, l'installation de Ruby via RubyInstaller est plus que suffisante et permet de gagner du temps, mais si vous avez des besoins très spécifiques (par exemple, vous voulez une version spécifique, vous devez personnaliser les options de compilation ou vous voulez simplement apprendre comment fonctionne le processus), vous pouvez installer Ruby en compilant le code source.
- Téléchargez la version souhaitée du code source à partir du site officiel de Ruby (ruby-lang.org/es/downloads/).
- Décompressez le package et suivez les instructions incluses pour le compiler (cela peut nécessiter des outils supplémentaires tels que Make, GCC, etc., que vous pouvez installer via MSYS2).
- Par défaut, le binaire sera installé dans C:\Ruby ou le dossier que vous choisissez lors de l'installation.
Cette méthode est généralement recommandée uniquement pour les utilisateurs avancés ou les environnements de développement très spécifiques, car elle nécessite plus de connaissances techniques et peut entraîner davantage de problèmes de compatibilité.
Erreurs courantes et conseils utiles
Lors de l'installation ou de l'utilisation de Ruby sous Windows, vous pouvez rencontrer certaines erreurs typiques :
- Problèmes avec le PATH : Si « ruby » n'est pas reconnu comme une commande, vérifiez que le dossier d'installation est correctement ajouté à la variable d'environnement PATH.
- Erreurs lors de l'installation des gemmes natives : Assurez-vous que DevKit ou MSYS2 est correctement configuré et mis à jour.
- Conflits de versions : Si vous travaillez sur plusieurs projets, utilisez un gestionnaire de versions comme rbenv pour Windows ou uru pour éviter toute confusion.
- Problèmes de dépendance Rails : Confirmez que vous disposez des versions correctes de Node.js, Yarn et SQLite avant de lancer un nouveau projet Rails.
Si à un moment donné vous vous trouvez bloqué, rappelez-vous que la documentation officielle (ruby-lang.org) et des forums spécialisés peuvent vous aider rapidement. De plus, vous trouverez de l'aide en espagnol et en anglais.
Que faire si je souhaite installer plusieurs outils et gestionnaires ?
De nombreux utilisateurs avancés utilisent des outils tiers pour gérer plusieurs versions de Ruby selon le projet. Ces gestionnaires, bien que non officiellement pris en charge sous Windows, peuvent s'avérer utiles :
- rbenv pour Windows : Adaptation de rbenv, compatible depuis la ligne de commande dans PowerShell.
- uru: Gestionnaire multiplateforme léger et facile à configurer.
Si vous travaillez principalement dans un environnement UNIX, les gestionnaires aiment asdf-vm o grassouillet peut être préférable, mais sous Windows, il est généralement plus pratique de s'en tenir à RubyInstaller et, le cas échéant, à uru.
Écrivain passionné par le monde des octets et de la technologie en général. J'aime partager mes connaissances à travers l'écriture, et c'est ce que je vais faire dans ce blog, vous montrer toutes les choses les plus intéressantes sur les gadgets, les logiciels, le matériel, les tendances technologiques et plus encore. Mon objectif est de vous aider à naviguer dans le monde numérique de manière simple et divertissante.

