El toolchain de Rust es el conjunto de herramientas que necesitamos para compilar, ejecutar y gestionar proyectos Rust.
Ya sabemos qué es Rust y por qué mola tanto. Ahora toca ensuciarnos las manos e instalar estas herramientas en nuestro ordenador.
A diferencia de otros lenguajes donde te descargas un instalador y “cruzas los dedos”, en Rust la gestión de herramientas es una delicia gracias a Rustup.
En este artículo vamos a ver cómo instalar Rust en Windows, Linux y macOS, y entenderemos qué estamos instalando exactamente.
¿Qué vamos a instalar?
Antes de copiar y pegar comandos, entendamos las tres piezas fundamentales que vamos a instalar:
- Rustc: Es el compilador. Es el encargado de coger tu código fuente y transformarlo en un binario ejecutable. (Siendo sinceros, rara vez lo llamaremos directamente, pero es el motor de todo).
- Cargo: Es el gestor de paquetes y construcción. Es la herramienta maravilla de Rust. Con Cargo descargamos librerías, compilamos proyectos, ejecutamos tests y generamos documentación.
- Rustup: Es el instalador y gestor de versiones. Rust evoluciona rápido (hay una nueva versión cada 6 semanas). Rustup nos permite actualizar el compilador o cambiar entre versiones (estable, beta, nightly) con un solo comando.
Nosotros interactuaremos principalmente con Cargo para el día a día y con Rustup para mantener el entorno actualizado.
Instalación en Windows
En Windows, la instalación tiene un pequeño requisito previo que suele ser el causante del 90% de los problemas de los novatos: las herramientas de construcción de C++.
Prerrequisitos: Microsoft C++ Build Tools
La toolchain MSVC de Rust necesita un linker (enlazador) para crear los .exe. Por defecto, utiliza las herramientas de Microsoft Visual Studio.
Si no tienes instalado Visual Studio, debes descargar las Microsoft C++ Build Tools.
- Descarga el instalador desde la web oficial de Microsoft.
- Durante la instalación, asegúrate de marcar la casilla “Desarrollo para el escritorio con C++”.
- Deja que termine y, por si acaso, reinicia el equipo.
Si te saltas este paso, Rust se instalará, pero al intentar compilar te dará un error de “Linker not found”.
El instalador rustup-init
Una vez tenemos las Build Tools:
- Ve a la página oficial rust-lang.org/tools/install.
- Descarga el archivo
rustup-init.exe. - Ejecútalo. Se abrirá una terminal.
- Te preguntará qué hacer. Simplemente pulsa
1yEnterpara proceder con la instalación por defecto.
Instalación en Linux y macOS
En sistemas basados en Unix, la instalación es increíblemente sencilla y se hace a través de la terminal con un script oficial.
Abre tu terminal y ejecuta:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | shEste script descargará e iniciará rustup. Te mostrará información sobre la instalación y te pedirá confirmación. Al igual que en Windows, generalmente la opción 1 (Proceed with installation (default)) es la correcta.
Si eres usuario de macOS y usas Homebrew, podrías instalarlo con brew install rust. Sin embargo, para este curso es preferible usar el comando curl anterior. Usar rustup es la forma “canónica” y te evitará problemas de versiones desactualizadas en el futuro.
Configurar el PATH
Una vez termine la instalación, verás un mensaje que dice algo como: “Rust is installed now. Great!”.
Para que la terminal reconozca los comandos cargo y rustc, puede ser necesario recargar las variables de entorno. Puedes cerrar y volver a abrir la terminal o, en Linux y macOS, ejecutar el comando que sugiere el instalador:
source "$HOME/.cargo/env"Verificando la instalación
Sea cual sea tu sistema operativo, vamos a comprobar que todo está en orden. Abre una terminal (o PowerShell en Windows) y ejecuta:
rustc --versionDeberías ver algo similar a:
rustc 1.xx.x (hash fecha)
Y también verificamos Cargo:
cargo --versionSi ambos comandos te devuelven una versión, ¡enhorabuena! Ya tienes el entorno base listo.
Manteniendo Rust actualizado
Como dijimos, Rust se actualiza frecuentemente. Gracias a rustup, actualizar es tan fácil como escribir:
rustup updateY si algún día decides que Rust no es para ti (esperamos que no sea el caso) o quieres limpiar tu instalación por completo:
rustup self uninstallNuestro primer contacto con Cargo
Aunque haremos el “Hola Mundo” oficial en un próximo artículo explicándolo línea a línea, vamos a probar que Cargo funciona correctamente creando un proyecto vacío.
Sitúate en la carpeta donde guardes tus proyectos y ejecuta:
cargo new prueba_instalacionEsto creará una carpeta llamada prueba_instalacion. Entra en ella:
cd prueba_instalacionY ahora, la prueba buena. Para compilar y ejecutar el programa por defecto, solo escribe:
cargo runSi ves en la consola un “Hello, world!”, tu toolchain funciona perfectamente. Cargo ha descargado dependencias (si las hubiera), ha invocado a rustc y ha ejecutado el binario resultante.
Con los cimientos puestos, en el siguiente artículo vamos a configurar nuestro editor. Dejamos el Bloc de Notas para emergencias y vamos a convertir VS Code en un IDE potente para Rust que nos ayude a programar y depurar.
