Guide Complet d'Installation de Ruby pour Débutants

Bienvenue dans le monde de la programmation Ruby ! Ce guide complet vous accompagnera dans l'installation de Ruby 3.x sur Windows 11, macOS 13+ et les distributions Linux modernes. Ruby est un langage de programmation élégant et expressif, parfait pour les débutants comme pour les professionnels.

Table des Matières

Introduction

Ruby est un langage de programmation dynamique et open-source, axé sur la simplicité et la productivité. Il possède une syntaxe élégante, naturelle à lire et facile à écrire. Avant de commencer, assurez-vous d'avoir les privilèges d'administrateur sur votre ordinateur.

Ce que vous allez apprendre :

  • Installer Ruby 3.x sur votre système d'exploitation
  • Configurer les outils de développement
  • Vérifier votre installation
  • Choisir et configurer un éditeur de code
  • Exécuter votre premier code Ruby

Installation sur Windows

Méthode 1 : RubyInstaller (Recommandé pour Windows 11/10)

  1. Télécharger RubyInstaller

    • Visitez RubyInstaller Downloads
    • Téléchargez Ruby+Devkit 3.x.x-x64 (dernière version 3.x)
    • Choisissez la version avec Devkit inclus

  2. Lancer l'Installeur

    • Double-cliquez sur le fichier .exe téléchargé
    • Acceptez le contrat de licence
    • Important : Cochez "Add Ruby executables to your PATH"
    • Cochez "Associate .rb and .rbw files with Ruby"
    • Cliquez sur "Install"

  3. Installer la chaîne d'outils de développement MSYS2

    • Après l'installation de Ruby, la configuration de MSYS2 apparaîtra
    • Choisissez l'option 3 (installer tous les composants)
    • Attendez que l'installation soit terminée

  4. Vérifier l'installation sur Windows

    ruby -v
gem -v

Méthode 2 : Sous-système Windows pour Linux (WSL)

Pour les utilisateurs avancés qui préfèrent un environnement Linux sur Windows :

  1. Activer WSL

    wsl --install

  2. Installez Ubuntu et suivez les instructions Linux ci-dessous

Installation sur macOS

Méthode 1 : rbenv (Recommandé pour macOS 13+)

  1. Installer Homebrew (si ce n'est pas déjà fait)

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

  2. Installer rbenv et ruby-build

    brew install rbenv ruby-build

  3. Configurer rbenv dans votre shell

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

  4. Installer Ruby 3.x

    rbenv install 3.3.0  # Utilisez la dernière version 3.x
rbenv global 3.3.0

  5. Vérifier l'installation de rbenv

    rbenv versions
ruby -v

Méthode 2 : asdf (Alternative)

  1. Installer asdf

    brew install asdf
echo -e "\n. $(brew --prefix asdf)/libexec/asdf.sh" >> ~/.zshrc
source ~/.zshrc

  2. Installer le plugin Ruby et Ruby

    asdf plugin add ruby
asdf install ruby latest
asdf global ruby latest

Méthode 3 : RVM (Ruby Version Manager)

  1. Installer RVM

    \curl -sSL https://get.rvm.io | bash -s stable
source ~/.rvm/scripts/rvm

  2. Installer Ruby

    rvm install 3.3.0
rvm use 3.3.0 --default

Installation sur Linux

Ubuntu/Debian (22.04+)

  1. Mettre à jour le gestionnaire de paquets

    sudo apt update
sudo apt upgrade -y

  2. Installer les dépendances

    sudo apt install -y git curl libssl-dev libreadline-dev zlib1g-dev \
autoconf bison build-essential libyaml-dev libreadline-dev libncurses5-dev \
libffi-dev libgdbm-dev libdb-dev

  3. Installer rbenv (Recommandé)

    git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
source ~/.bashrc

  4. Installer ruby-build

    git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build

  5. Installer Ruby 3.x

    rbenv install 3.3.0
rbenv global 3.3.0

Fedora/RHEL (36+)

  1. Installer les dépendances

    sudo dnf install -y git curl gcc bison libffi-devel libyaml-devel \
make autoconf automake libtool readline-devel openssl-devel

  2. Installer rbenv et Ruby (suivez les étapes 3 à 5 de la section Ubuntu)

Arch Linux

  1. Installer depuis les dépôts officiels

    sudo pacman -S ruby

  2. Ou installer rbenv depuis AUR

    yay -S rbenv ruby-build

Étapes de Vérification

Après l'installation, vérifiez que tout fonctionne :

  1. Vérifier la version de Ruby

    ruby -v
# Devrait afficher : ruby 3.x.x

  2. Vérifier le gestionnaire de gems

    gem -v

  3. Vérifier bundler

    gem install bundler
bundle -v

  4. Créer un fichier de test

    # test.rb
puts "Bonjour, Ruby !"
puts "Version de Ruby : #{RUBY_VERSION}"

  5. Lancer le test

    ruby test.rb

Éditeurs de Code

Visual Studio Code (Recommandé)

  1. Télécharger et installer VS Code

  2. Installer les extensions Ruby

    • Ruby (par Peng Lv)
    • Ruby Solargraph (pour l'autocomplétion)
    • VSCode Ruby (par Stafford Brunk)

  3. Configurer VS Code

    • Ouvrir la Palette de Commandes (Ctrl/Cmd + Shift + P)
    • Taper "Ruby: Configure"
    • Sélectionner votre version de Ruby

Sublime Text

  1. Télécharger Sublime Text

  2. Installer Package Control

  3. Installer les paquets Ruby

    • RubyTest
    • SublimeLinter-ruby
    • Ruby Enhanced

Ruby Interactif (IRB)

IRB est le shell interactif de Ruby. Essayez ces commandes :

  1. Démarrer IRB

    irb

  2. Expressions Ruby de base

    puts "Bonjour, le Monde !"
2 + 2
"Ruby est génial !".upcase

  3. Quitter IRB

    exit

Dépannage

Problèmes Courants

1. "ruby: command not found"

  • Assurez-vous que Ruby est dans votre PATH
  • Redémarrez votre terminal/invite de commande
  • Vérifiez à nouveau les étapes d'installation

2. Erreurs "Permission denied"

  • N'utilisez pas sudo gem install
  • Utilisez rbenv/rvm pour gérer les versions de Ruby
  • Vérifiez les permissions des fichiers

3. Windows : "MSYS2 installation failed"

  • Installez Visual Studio Build Tools
  • Lancez l'installeur en tant qu'Administrateur
  • Désactivez temporairement l'antivirus

4. macOS : "Xcode Command Line Tools required"

xcode-select --install

5. Erreurs de certificat SSL

# Mettre à jour les certificats
gem update --system

Obtenir de l'Aide

  • Documentation Ruby : ruby-doc.org
  • Communauté Ruby : ruby-lang.org
  • Stack Overflow : Taguez vos questions avec "ruby"
  • Reddit : r/ruby

Prochaines Étapes

Félicitations ! Vous avez maintenant installé Ruby. Voici quoi faire ensuite :

  1. Apprendre les bases de Ruby avec Ruby en Vingt Minutes
  2. Essayer Ruby en ligne sur Try Ruby
  3. Construire votre premier projet - peut-être une calculatrice simple ou une liste de tâches
  4. Rejoindre la communauté et commencer à contribuer à l'open source

Rappelez-vous : La programmation est un voyage, pas une destination. Prenez votre temps, pratiquez régulièrement, et n'hésitez pas à demander de l'aide. Bienvenue dans le monde merveilleux de la programmation Ruby ! 🎉

Ce guide est maintenu par la communauté Ruby. Dernière mise à jour : Mars 2026