Guía Completa de Instalación de Ruby para Principiantes

¡Bienvenido al mundo de la programación Ruby! Esta guía completa te llevará a través de la instalación de Ruby 3.x en Windows 11, macOS 13+ y distribuciones Linux modernas. Ruby es un lenguaje de programación hermoso y expresivo que es perfecto para principiantes y profesionales por igual.

Índice

Introducción

Ruby es un lenguaje de programación dinámico y de código abierto con un enfoque en la simplicidad y la productividad. Tiene una sintaxis elegante que es natural de leer y fácil de escribir. Antes de comenzar, asegúrate de tener privilegios de administrador en tu computadora.

Lo que aprenderás:

  • Instalar Ruby 3.x en tu sistema operativo
  • Configurar herramientas de desarrollo
  • Verificar tu instalación
  • Elegir y configurar un editor de código
  • Ejecutar tu primer código Ruby

Instalación en Windows

Método 1: RubyInstaller (Recomendado para Windows 11/10)

  1. Descargar RubyInstaller

    • Visita RubyInstaller Downloads
    • Descarga Ruby+Devkit 3.x.x-x64 (versión 3.x más reciente)
    • Elige la versión con Devkit incluido

  2. Ejecutar el Instalador

    • Haz doble clic en el archivo .exe descargado
    • Acepta el acuerdo de licencia
    • Importante: Marca "Añadir ejecutables Ruby a tu PATH"
    • Marca "Asociar archivos .rb y .rbw con Ruby"
    • Haz clic en "Instalar"

  3. Instalar Toolchain MSYS2

    • Después de la instalación de Ruby, aparecerá la configuración de MSYS2
    • Elige la opción 3 (instalar todos los componentes)
    • Espera a que se complete la instalación

  4. Verificar Instalación en Windows

    ruby -v
gem -v

Método 2: Windows Subsystem for Linux (WSL)

Para usuarios avanzados que prefieren ambiente Linux en Windows:

  1. Habilitar WSL

    wsl --install

  2. Instalar Ubuntu y seguir instrucciones de Linux abajo

Instalación en macOS

Método 1: rbenv (Recomendado para macOS 13+)

  1. Instalar Homebrew (si aún no está instalado)

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

  2. Instalar rbenv y ruby-build

    brew install rbenv ruby-build

  3. Configurar rbenv en tu shell

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

  4. Instalar Ruby 3.x

    rbenv install 3.3.0  # Usa la versión 3.x más reciente
rbenv global 3.3.0

  5. Verificar instalación de rbenv

    rbenv versions
ruby -v

Método 2: asdf (Alternativa)

  1. Instalar asdf

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

  2. Instalar plugin Ruby y Ruby

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

Método 3: RVM (Ruby Version Manager)

  1. Instalar RVM

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

  2. Instalar Ruby

    rvm install 3.3.0
rvm use 3.3.0 --default

Instalación en Linux

Ubuntu/Debian (22.04+)

  1. Actualizar gestor de paquetes

    sudo apt update
sudo apt upgrade -y

  2. Instalar dependencias

    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. Instalar rbenv (Recomendado)

    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. Instalar ruby-build

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

  5. Instalar Ruby 3.x

    rbenv install 3.3.0
rbenv global 3.3.0

Fedora/RHEL (36+)

  1. Instalar dependencias

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

  2. Instalar rbenv y Ruby (sigue pasos 3-5 de la sección Ubuntu)

Arch Linux

  1. Instalar desde repositorios oficiales

    sudo pacman -S ruby

  2. O instalar rbenv desde AUR

    yay -S rbenv ruby-build

Pasos de Verificación

Después de la instalación, verifica que todo funcione:

  1. Verificar versión de Ruby

    ruby -v
# Debe mostrar: ruby 3.x.x

  2. Verificar gestor de gems

    gem -v

  3. Verificar bundler

    gem install bundler
bundle -v

  4. Crear un archivo de prueba

    # test.rb
puts "¡Hola, Ruby!"
puts "Versión de Ruby: #{RUBY_VERSION}"

  5. Ejecutar la prueba

    ruby test.rb

Editores de Código

Visual Studio Code (Recomendado)

  1. Descargar e instalar VS Code

  2. Instalar extensiones Ruby

    • Ruby (por Peng Lv)
    • Ruby Solargraph (para autocompletado)
    • VSCode Ruby (por Stafford Brunk)

  3. Configurar VS Code

    • Abre Paleta de Comandos (Ctrl/Cmd + Shift + P)
    • Escribe "Ruby: Configure"
    • Selecciona tu versión de Ruby

Sublime Text

  1. Descargar Sublime Text

  2. Instalar Package Control

  3. Instalar paquetes Ruby

    • RubyTest
    • SublimeLinter-ruby
    • Ruby Enhanced

Ruby Interactivo (IRB)

IRB es el shell interactivo de Ruby. Prueba estos comandos:

  1. Iniciar IRB

    irb

  2. Expresiones básicas de Ruby

    puts "¡Hola, Mundo!"
2 + 2
"¡Ruby es increíble!".upcase

  3. Salir de IRB

    exit

Solución de Problemas

Problemas Comunes

1. "ruby: command not found"

  • Asegúrate de que Ruby esté en tu PATH
  • Reinicia tu terminal/prompt de comandos
  • Verifica los pasos de instalación nuevamente

2. Errores de "Permiso denegado"

  • No uses sudo gem install
  • Usa rbenv/rvm para gestionar versiones de Ruby
  • Verifica los permisos de archivo

3. Windows: "Instalación MSYS2 falló"

  • Instala Visual Studio Build Tools
  • Ejecuta el instalador como Administrador
  • Desactiva antivirus temporalmente

4. macOS: "Herramientas de Línea de Comando Xcode requeridas"

xcode-select --install

5. Errores de certificado SSL

# Actualizar certificados
gem update --system

Obteniendo Ayuda

  • Documentación Ruby: ruby-doc.org
  • Comunidad Ruby: ruby-lang.org
  • Stack Overflow: Etiqueta tus preguntas con "ruby"
  • Reddit: r/ruby

Próximos Pasos

¡Felicitaciones! Ahora tienes Ruby instalado. Aquí está qué hacer a continuación:

  1. Aprende Ruby básico con Ruby en Veinte Minutos
  2. Prueba Ruby en línea en Try Ruby
  3. Construye tu primer proyecto - tal vez una calculadora simple o lista de tareas
  4. Únete a la comunidad y empieza a contribuir a código abierto

Recuerda: Programar es un viaje, no un destino. Tómate tu tiempo, practica regularmente y no dudes en pedir ayuda. ¡Bienvenido al maravilloso mundo de la programación Ruby! 🎉

Esta guía es mantenida por la comunidad Ruby. Última actualización: Marzo 2026