← Índice

0.1 El banco vacío

Esta traducción fue asistida por IA y revisada superficialmente. Si encuentras errores o algo no suena natural, escríbeme - lo agradezco.

La gente con experiencia rara vez explica el primer paso. Para ellos dejó de ser un paso hace mucho - es simplemente algo que se hizo en algún momento, nadie recuerda cuándo, y desde entonces siempre ha estado listo. El aprendiz que entra al taller por primera vez encuentra un banco vacío y entiende algo importante: antes de que pueda empezar el trabajo, hay otro trabajo que hacer. Las herramientas no aparecen solas.

Lo que necesitas

El taller de Rust tiene tres herramientas principales. rustc es el compilador: toma el código fuente y lo convierte en un ejecutable. cargo es el ayudante: construye proyectos, gestiona dependencias y ejecuta tests. rustup es el instalador y guardián: sabe cómo obtener ambas herramientas y mantenerlas actualizadas.

No necesitas instalar rustc ni cargo directamente. rustup se encargará de traerlos.

Instalación

En Linux y macOS, un solo comando es suficiente:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

El script preguntará sobre las opciones de instalación. La opción por defecto funciona en la mayoría de los casos - pulsa 1 y Enter. Una vez que termine, reinicia el terminal o ejecuta:

source "$HOME/.cargo/env"

En Windows, descarga y ejecuta rustup-init.exe desde la página oficial rustup.rs - el proceso es el mismo, pero con un instalador gráfico.

Cuando la instalación esté completa, confirma que las herramientas responden:

rustc --version
cargo --version

La salida tiene este aspecto:

rustc 1.95.0 (59807616e 2026-04-14)
cargo 1.95.0 (f2d3ce0bd 2026-03-21)

Los números exactos dependen de cuándo instalaste. Lo que importa es que los comandos devuelvan una versión, no un error.

El resultado

Herramientas en la pared. rustc y cargo responden cuando se les llama. El banco está listo.


Lore: Empezar de cero

A veces es útil confirmar que la instalación está limpia - especialmente si Rust ya estaba en la máquina en algún estado desconocido. rustup puede eliminarse por completo: las herramientas, todas las versiones del compilador instaladas, la caché - todo.

rustup self uninstall

El comando elimina los directorios ~/.rustup y ~/.cargo y borra las entradas del perfil del shell. Después de ejecutarlo, el sistema vuelve al estado en que estaba antes de que Rust fuera instalado. No quedan rastros.


Lore: rustup y las versiones de Rust

rustup no es solo un instalador. Gestiona múltiples versiones de Rust simultáneamente y sabe cómo actualizarlas sin intervención manual.

Rust tiene tres canales de publicación: stable, beta y nightly. Stable se publica cada seis semanas y garantiza compatibilidad hacia atrás - el código escrito hoy compilará dentro de un año. Nightly se construye diariamente desde el compilador más reciente; incluye características experimentales que aún no están listas para stable. Beta es el próximo ciclo stable pasando por sus comprobaciones finales.

Stable es suficiente para todo el trabajo de este grimoire. Puedes actualizar el toolchain en cualquier momento con un comando:

rustup update