Haskell · toolchain · configuración

Instalar Haskell con GHCup: la guía del toolchain de 2026

Si empiezas con Haskell en 2026, la pregunta "¿cómo lo instalo?" tiene una respuesta clara: GHCup. Es el instalador y gestor de versiones oficial y multiplataforma de todo el toolchain — el compilador (GHC), la herramienta de compilación (cabal-install), Stack y el backend del editor (HLS, el Haskell Language Server). Esta guía te lleva paso a paso por una instalación limpia, el cambio de versiones y los problemas con los que la gente tropieza más a menudo.

Qué gestiona realmente GHCup

GHCup es una única herramienta que instala y permite cambiar entre múltiples versiones de cada componente, así que nunca quedas atado a un solo compilador:

• GHC — el Glasgow Haskell Compiler.
• cabal-install — la herramienta de compilación cabal y resolutor de dependencias.
• Stack — una herramienta de compilación alternativa con snapshots curados.
• HLS — el Haskell Language Server, que da vida al autocompletado, la información de tipos y las refactorizaciones en VS Code, Neovim y otros editores.

Reemplazó al antiguo paquete "Haskell Platform" precisamente porque los proyectos reales necesitan versiones diferentes de GHC, y GHCup hace que cambiar sea trivial.

Instalar GHCup

En Linux y macOS, el comando oficial de una línea descarga un instalador interactivo:

curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh

Como con cualquier script de instalación, lee primero qué hace — el código fuente está en GitHub (haskell/ghcup-hs). En Windows, ejecuta el instalador de PowerShell documentado en el sitio de GHCup; configura el mismo toolchain más el entorno MSYS2 requerido.

El instalador ofrece añadir GHCup a tu perfil de shell para que ghc, cabal y compañía estén en tu PATH. Acéptalo y luego reinicia tu shell.

La vía interactiva: ghcup tui

La forma más rápida de gestionar versiones es la interfaz de terminal:

ghcup tui

Lista todas las versiones disponibles de GHC, Cabal, Stack y HLS con su estado (instalada, activa, recomendada). Seleccionas qué instalar o activar con el teclado — sin necesidad de memorizar comandos.

Los equivalentes en línea de comandos

Si prefieres los scripts o la CI, las mismas acciones son comandos sencillos:

# install the recommended versions
ghcup install ghc recommended
ghcup install cabal recommended
ghcup install hls recommended

# make a specific GHC the active one
ghcup set ghc 9.10.1

# see what is installed
ghcup list

Usa los números de versión que GHCup marca como recommended a menos que un proyecto fije algo específico en su cabal.project o stack.yaml.

Primera build, para confirmar que funciona

cabal update          # refresh the package index
mkdir hello && cd hello
cabal init --simple --non-interactive
cabal run

Si eso imprime salida, tu toolchain está sano. A partir de aquí, la build en sí es paralela por defecto — consulta nuestra guía sobre cómo Cabal usa tus núcleos, y los cambios más profundos que llegaron con Cabal 2.0 y el modelo new-build.

Problemas habituales

• PATH no actualizado. Si ghc da "command not found" tras instalar, te saltaste el paso del perfil — vuelve a ejecutar el instalador o haz source de ~/.ghcup/env.
• Desajuste de versión de HLS. El Haskell Language Server debe soportar tu GHC activo. Si el HLS de tu editor no carga, instala la build de HLS que coincida con tu GHC mediante ghcup tui.
• GHC del sistema eclipsando a GHCup. Un GHC instalado desde el gestor de paquetes de tu sistema operativo puede tener prioridad en el PATH. Prefiere el gestionado por GHCup y elimina o quita prioridad al paquete del sistema.
• Índice de paquetes obsoleto. Los errores de resolución tras un largo intervalo normalmente solo necesitan cabal update.

Para el vocabulario usado en estas guías — planes de instalación, snapshots, sandboxes — la antigua guía de sandboxes de Cabal cubre cómo evolucionó el aislamiento hasta las builds por proyecto de hoy.

¿Stack o Cabal después de GHCup?

GHCup instala ambos, así que la elección es tuya. Cabal, con su moderno modelo de build por proyecto, es la opción por defecto con la que la mayoría de los recién llegados deberían empezar; Stack añade snapshots curados de paquetes que algunos equipos prefieren por reproducibilidad. Ambos funcionan con el GHC que gestiona GHCup, y puedes cambiar más adelante sin reinstalar el compilador.

Preguntas frecuentes

¿Es GHCup la forma oficial de instalar Haskell? Sí — es el instalador recomendado en haskell.org y el punto de entrada estándar del toolchain en 2026.

¿Funciona GHCup en Windows? Sí, mediante su instalador de PowerShell, que además configura el entorno MSYS2 que GHC necesita en Windows.

¿Puedo tener varias versiones de GHC a la vez? Sí — esa es justamente la idea. Instala muchas y cambia la activa con ghcup set ghc <version>.

¿Sigo necesitando la Haskell Platform? No. GHCup la sustituyó; instala los componentes que necesites de forma individual.