No entres en pánico: «No default toolchain configured» en Rust — solución

Introducción: El dolor familiar de todo principiante en Rust

Acabas de instalar Rust, siguiendo las instrucciones del sitio oficial, abres la terminal y con el corazón latiendo escribes rustc --version. Y entonces, ¡pum! — en lugar de una bonita línea con el número de versión, ves un texto frío y aterrador: «No default toolchain configured after installing rustup».

¿Te suena familiar? Si es así, no estás solo. Esta pregunta en Stack Overflow ha acumulado miles de visitas y decenas de comentarios. Pero no entres en pánico ni borres todo de inmediato. En este artículo, analizaremos qué es un toolchain, por qué rustup no puede encontrarlo y, lo más importante, cómo solucionarlo de una vez por todas. Recorreremos el camino desde cero hasta un entorno de desarrollo funcional en Rust.

¿Listo? ¡Vamos allá!

¿Qué es un toolchain y por qué rustup «se olvida» de él?

Antes de meternos en detalles, aclaremos los conceptos. Un toolchain (cadena de herramientas) es un conjunto de herramientas necesarias para compilar y construir código en Rust. Incluye:

\n
• rustc — el compilador en sí;
\n
• cargo — el gestor de paquetes y sistema de construcción;
\n
• rust-std — la biblioteca estándar;
\n
• Y otros componentes (por ejemplo, clippy para linting).
\n

Rustup es el instalador y gestor de versiones oficial de Rust. Permite cambiar entre diferentes versiones del compilador: estable (stable), nocturna (nightly) y de prueba (beta). Cuando escribes rustup install stable, rustup descarga el toolchain correspondiente y lo guarda en el disco.

El error «No default toolchain configured» ocurre cuando rustup no puede determinar qué versión del toolchain usar por defecto. Es similar a cuando llegas a una biblioteca pero no sabes qué libro leer primero. Rustup simplemente no sabe qué compilador ejecutar.

Las causas pueden ser varias:

\n
• Acabas de instalar rustup pero no has instalado ningún toolchain;
\n
• La instalación se interrumpió debido a problemas de red;
\n
• Eliminaste el toolchain manualmente;
\n
• Problemas de permisos de acceso a la carpeta ~/.rustup.
\n

Diagnóstico: Verificamos el estado actual

Antes de arreglar algo, veamos qué tenemos. Abre la terminal y ejecuta el comando:

rustup show

Deberías ver algo como esto (si todo está mal):

Default host: x86_64-unknown-linux-gnu\nrustup home:  /home/user/.rustup\n\ninstalled toolchains\n--------------------\n\nactive toolchain\n----------------\n(no active toolchain)

Presta atención a la línea «no active toolchain». Esta es la raíz del problema. Vamos a solucionarlo.

Solución n.º 1: Instalación y configuración del toolchain por defecto

La forma más sencilla y común es instalar explícitamente el toolchain estable y asignarlo como versión por defecto.

Ejecuta en la terminal:

rustup install stable

Este comando descargará e instalará la última versión estable de Rust. El proceso puede tomar algún tiempo (generalmente de 1 a 3 minutos, dependiendo de la velocidad de tu internet).

Una vez completada la instalación, debes «vincular» este toolchain como la versión por defecto:

rustup default stable

Ahora verifica el resultado:

rustup show

Deberías ver un toolchain activo. También puedes verificar el compilador:

rustc --version

Si ves algo como rustc 1.78.0 (9b00956e5 2024-04-29) — ¡felicidades, el problema está resuelto!

Solución n.º 2: Uso del toolchain nightly (para experimentadores)

A veces puedes necesitar la versión nocturna del compilador, por ejemplo, para