Instalar Rust

Tabla de contenidos

Cómo instalar Rust

Qué se instala

Dónde se instala

Cómo verificar la instalación

Para actualizar

Cómo preparar tu editor favorito

Cómo desinstalar

Cómo instalar Rust

Lo más recomendable es usar rustup (no está de más echar un ojo a la documentación original), aunque basta con seguir las instrucciones sugeridas en https://rustup.rs.

En mi caso instalo en un Subsistema de Windows para Linux (WSL) con Ubuntu. No es necesario ser superusuario para ejecutar:

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

También requerirá la instalación del software necesario para compilar y vincular las librerías:

$ sudo apt install build-essential

Y puede ser útil, por ejemplo para compilar programas que usen r2d2 con MySQL, instalar:

$ sudo apt install libssl-dev pkg-config

Qué se instala

Se recomienda la instalación por defecto. Si ese es tu caso, pasa al siguiente apartado. Pero hay otras opciones.

Puedes elegir la versión del conjunto de herramientas (o toolchain) de Rust que quieres usar. Básicamente stable (por defecto), beta (candidata a próxima versión) o nightly (con funcionalidades experimentales).

Por ejemplo, para añadir a tu instalación la versión nightly puedes ejecutar:

$ rustup toolchain install nightly

y comprobar que se ha instalado correctamente:

$ rustup run nightly rustc --version

Si quieres mantener por defecto la versión nightly ejecuta:

$ rustup default nightly

También puedes usar diferentes perfiles de instalación, minimal, default (por defecto) o complete, aunque no se recomienda esta última (mejor añadir componentes usando rustup component add).

Con el perfil minimal se instalan las herramientas esenciales:

rustc – el compilador.
rust-std – la librería estándar de Rust.
cargo – el gestor de dependencias y proyectos.

Y en el perfil default se añaden:

rustdoc – la herramienta para generar documentación desde el código.
rustfmt – para formatear el código usando criterios comunes para todos.
clippy – para detectar errores habituales y mejorar el código.

Para cambiar de perfil sólo hay que ejecutar:

$ rustup set profile minimal

Dónde se instala

En $HOME/.rustup y $HOME/.cargo. Los comandos en $HOME/.cargo/bin.
La instalación actualizará la variable de entorno PATH. Si no es así entonces hay que añadir manualmente el camino /Users/USUARIO/.cargo/bin (según sistema operativo). Y reiniciar la shell de la línea de comandos.

Cómo verificar la instalación

Puedes probar algunos comandos:

$ rustup show
Default host: x86_64-unknown-linux-gnu

stable-x86_64-unknown-linux-gnu (default)
rustc 1.58.1 (db9d1b20b 2022-01-20)

$ cargo --version
cargo 1.58.0 (f01b232bc 2022-01-19)

$ rustdoc --version
rustdoc 1.58.1 (db9d1b20b 2022-01-20)