Cómo instalar Ruby en Windows paso a paso

¿Quieres ponerte manos a la obra con Ruby en tu PC con Windows y todavía no tienes claro cómo empezar? Tranquilo, no es nada complicado si sigues una guía clara que te explique cada paso y evite los problemillas más habituales que suelen surgir. Además, si has leído varios tutoriales y te ha parecido que cada uno aborda el proceso de forma distinta (o deja cosas importantes sin aclarar), aquí vas a encontrar una explicación exhaustiva y sin tecnicismos complicados, que aúna toda la información relevante disponible y te la presenta de forma fácil, ordenada y actualizada.

Vamos a desgranar todo lo que necesitas saber para instalar Ruby en Windows, ya sea para programar tus propios scripts, para desarrollar con frameworks como Ruby on Rails, o simplemente para aprender el lenguaje desde cero. Presta atención porque, además, añadiremos recomendaciones útiles para evitar errores frecuentes y optimizar tu entorno de desarrollo desde el principio.

¿Por qué instalar Ruby en Windows y qué opciones existen?

Ruby es un lenguaje de programación versátil y fácil de aprender, ideal tanto para quienes dan sus primeros pasos en la programación como para profesionales que buscan una herramienta potente y flexible. Aunque es más habitual encontrarlo en sistemas Linux o macOS, cada vez son más los desarrolladores que optan por Windows, sobre todo con herramientas como RubyInstaller que simplifican el proceso.

Gracias a RubyInstaller, instalar Ruby en Windows es más sencillo que nunca, ya que incluye todo lo necesario para comenzar a trabajar de inmediato. Pero, además, existen otros métodos para quienes buscan administrar varias versiones de Ruby, o requieren personalizar la instalación para proyectos concretos, como los gestores de versiones, la línea de comandos y la compilación manual del código fuente.

Una de las mayores ventajas de utilizar RubyInstaller es que integra el entorno MSYS2, lo que facilita la instalación de gemas nativas y dependencias, haciendo posible trabajar en proyectos complejos como Ruby on Rails sin complicaciones adicionales.

Herramientas y requisitos previos

Antes de ponerte a instalar Ruby, es recomendable contar con una serie de herramientas básicas en tu equipo:

• Git: Muy útil para gestionar tus proyectos y descargar código fuente desde repositorios online como GitHub.
• Editor de texto: Atom, VS Code o Sublime Text son buenas opciones para editar código Ruby.
• Node.js y Yarn: Necesarios si piensas trabajar con Ruby on Rails o con herramientas modernas del ecosistema JavaScript.
• SQLite: Recomendado si vas a comenzar proyectos Rails, ya que suele ser el sistema de base de datos por defecto.

No te preocupes si aún no tienes alguno de estos elementos, porque a continuación repasaremos cómo instalarlos y configurarlos de forma sencilla.

Paso 1: Instalando Git en Windows

Git es fundamental para cualquier desarrollador moderno. Para instalarlo en Windows, simplemente accede a la web oficial de Git (https://git-scm.com/download/win), descarga el instalador que corresponda a tu sistema (normalmente, 64 bits) y sigue los pasos del asistente. Durante la instalación, puedes dejar seleccionadas las opciones por defecto, eligiendo Git Bash como emulador de terminal. Al terminar, puedes abrir Git Bash y comprobar si todo funciona bien ejecutando el comando git –version.

Paso 2: Descargando y usando RubyInstaller

El método más recomendable y habitual para instalar Ruby en Windows es a través de RubyInstaller, una herramienta oficial que integra tanto el intérprete como los componentes esenciales para el desarrollo.

Para obtener la última versión:

• Ve a la web oficial de RubyInstaller: https://rubyinstaller.org/
• Descarga el instalador más actual, buscando la variante que incluye Devkit. Ejemplo: «Ruby+Devkit 3.x.x (x64)».
• Ejecuta el instalador, acepta la licencia y selecciona la opción para añadir Ruby a la variable PATH de Windows. Esto facilitará que puedas usar Ruby desde cualquier terminal.
• En el último paso, asegúrate de dejar seleccionada la opción para instalar MSYS2 y las herramientas de desarrollo necesarias. Cuando termines, se abrirá una terminal que ejecutará la configuración automática de MSYS2 con varias opciones; normalmente la opción 3 cubre todo lo necesario para la mayoría de usuarios.

Para comprobar que Ruby se ha instalado correctamente, abre Git Bash o cualquier terminal y ejecuta ruby -v. Si todo ha ido bien, verás en pantalla la versión instalada.

Paso 3: Instalando Ruby DevKit y configurando el entorno

El DevKit es esencial para compilar algunas gemas que requieren componentes nativos. Si has instalado Ruby con el paquete +Devkit, normalmente ya tendrás todo lo necesario. No obstante, si necesitas instalarlo manualmente:

• Descarga el paquete DevKit desde la web de RubyInstaller.
• Ejecuta el instalador y extrae los archivos en una carpeta, por ejemplo «C:\DevKit».
• Abre una ventana de comandos (cmd.exe), navega a la carpeta del DevKit y ejecuta:

> chdir C:\DevKit
> ruby dk.rb init
> ruby dk.rb install

Paso 4: Instalando y configurando componentes adicionales (Node.js, Yarn y SQLite)

Cuando planeas crear proyectos web con Ruby on Rails, necesitarás además Node.js y Yarn para gestionar los recursos JavaScript, así como SQLite si usas la configuración por defecto de Rails.

• Node.js: Ve a nodejs.org, descarga la versión LTS recomendada y sigue los pasos. Durante la instalación, asegúrate de marcar la opción para instalar las herramientas adicionales si te lo solicita.
• Yarn: Descarga el instalador desde la web oficial de Yarn y sigue los pasos en pantalla.
• SQLite: Descarga los archivos sqlite-dll-win64-x64-XXXXXX.zip y sqlite-tools-win32-x86-XXXXXX.zip desde la web oficial, descomprime su contenido en la carpeta C:\Windows\System32 para que sean accesibles como comandos globales.

Confirma que todo ha quedado bien ejecutando en la terminal los comandos node -v, yarn -v y sqlite3 –version. Deberías ver las versiones instaladas sin problemas.

Paso 5: Verificando la instalación de Ruby

Para asegurarte de que Ruby está totalmente operativo, abre una terminal y escribe:

ruby -v

Deberías ver la versión que has instalado. Además puedes probar la instalación de gemas, por ejemplo con:

gem install bundler

Si todo va bien, ya tienes tu entorno listo para avanzar. Si recibes algún mensaje de error, revisa que has añadido Ruby a la variable PATH y que completaste la instalación de MSYS2.

Paso 6: Instalando Rails y tus primeras gemas

El siguiente paso habitual es instalar Rails, el framework más emblemático del ecosistema Ruby. Para hacerlo, basta con ejecutar en la terminal:

gem install rails

La instalación puede tardar varios minutos, ya que se descargan y compilan muchas dependencias. Una vez completada, verifica la instalación con:

rails -v

Además de Rails, es muy recomendable instalar Bundler (aunque normalmente se instala automáticamente). Bundler es la gema encargada de gestionar el resto de dependencias en tus proyectos Ruby:

gem install bundler

Creando y arrancando tu primer proyecto Ruby on Rails

Si quieres ir un paso más allá y comprobar que todo funciona correctamente, puedes crear tu primer proyecto con Rails:

rails new mi_app_de_prueba

Cuando termine el proceso, accede al nuevo directorio y arranca el servidor:

cd mi_app_de_prueba
rails server

Abre tu navegador y accede a http://localhost:3000. Deberías ver la pantalla de bienvenida de Rails, señal de que tienes Ruby y todos los componentes correctamente instalados y configurados en tu Windows.

No olvides que puedes cerrar el servidor pulsando Ctrl + C en la terminal.

Gestores de versiones: cómo manejar varias instalaciones de Ruby

Si necesitas trabajar en distintos proyectos con requisitos diferentes sobre la versión de Ruby (por ejemplo, una app antigua y otra recién creada), existen gestores de versiones específicos para Windows, como rbenv para Windows (adaptado a PowerShell) o uru, que permiten cambiar entre versiones fácilmente y están diseñados para integrarse de forma nativa.

Otros gestores muy populares como asdf-vm y chruby suelen estar más enfocados a entornos UNIX, pero si tienes experiencia puedes utilizarlos también en Windows con ciertas adaptaciones.

Instalación manual y compilación de Ruby desde el código fuente

En la mayoría de los casos, instalar Ruby a través de RubyInstaller es más que suficiente y ahorra tiempo, pero si tienes necesidades muy concretas (por ejemplo, quieres una versión específica, necesitas personalizar las opciones de compilación, o simplemente quieres aprender cómo funciona el proceso), puedes instalar Ruby compilando el código fuente.

1. Descarga la versión deseada del código fuente desde la web oficial de Ruby (ruby-lang.org/es/downloads/).
2. Descomprime el paquete y sigue las instrucciones incluidas para compilarlo (puede requerir herramientas adicionales como Make, GCC, etc., que puedes instalar a través de MSYS2).
3. Por defecto el binario se instalará en C:\Ruby o la carpeta que elijas durante la configuración.

Este método suele estar recomendado solo para usuarios avanzados o entornos de desarrollo muy especiales, ya que requiere mayor conocimiento técnico y puede dar más problemas de compatibilidad.

Errores comunes y consejos útiles

Durante la instalación o el uso de Ruby en Windows puedes encontrar algunos fallos típicos:

• Problemas con el PATH: Si «ruby» no se reconoce como comando, revisa que la carpeta de instalación esté correctamente añadida a la variable de entorno PATH.
• Errores al instalar gemas nativas: Asegúrate de que tienes DevKit o MSYS2 correctamente configurados y actualizados.
• Conflictos entre versiones: Si trabajas en varios proyectos, utiliza un gestor de versiones como rbenv para Windows o uru para evitar líos.
• Problemas con dependencias de Rails: Confirma que tienes Node.js, Yarn y SQLite en sus versiones correctas antes de lanzar un nuevo proyecto Rails.

Si en algún punto te encuentras atascado, recuerda que la documentación oficial (ruby-lang.org) y foros especializados pueden ayudarte rápidamente. Además, puedes encontrar ayuda de la comunidad tanto en español como en inglés.

¿Y si quiero instalar varias herramientas y gestores?

Muchos usuarios avanzados utilizan herramientas de terceros para gestionar varias versiones de Ruby según el proyecto. Estos gestores, aunque no están soportados oficialmente en Windows, pueden ser útiles:

• rbenv para Windows: Adaptación de rbenv, compatible desde línea de comandos en PowerShell.
• uru: Gestor multiplataforma ligero, fácil de configurar.

Si trabajas principalmente en entorno UNIX, gestores como asdf-vm o chruby pueden ser preferibles, pero en Windows lo más práctico suele ser mantenerse con RubyInstaller y, si acaso, uru.