Saltar al contenido principal

Instalar Rust

Instalación

El primer paso para usar Rust es instalarlo. Descargaremos Rust a través de rustup, una herramienta de línea de comandos para gestionar versiones de Rust y herramientas asociadas. Se requiere una conexión a internet para la descarga.

Nota: Si por alguna razón prefieres no utilizar rustup, consulta la página de Otros Métodos de Instalación de Rust para más opciones de instalación.

Los pasos a continuación instalarán la última versión estable del compilador de Rust. Las diferentes versiones pueden variar ligeramente, ya que Rust a menudo mejora los mensajes de error y advertencias. Sin embargo, cualquiera de las versiones estables más recientes de Rust instaladas mediante estos pasos deberían poder ejecutar todo el contenido de este libro.

Notación de Línea de Comandos

A lo largo de este libro, y en particular en este capítulo, mostraremos algunos comandos utilizados en la terminal. Todas las líneas que debes ingresar en tu terminal comienzan con $. No necesitas escribir el carácter $; está ahí para denotar el inicio de cada comando. Las líneas que no comienzan con $ típicamente muestran la salida del comando anterior. Además, los ejemplos específicos de PowerShell usarán > en lugar de $.

Instalar rustup en Linux o macOS

Si estás usando Linux o macOS, abre una terminal e introduce el siguiente comando:

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

Este comando descargará un script e iniciará la instalación de la herramienta rustup, que instala la última versión estable de Rust. Durante el proceso, puede que se te solicite tu contraseña. Si la instalación es exitosa, verás el siguiente mensaje:

Rust is installed now. Great!

Además, necesitarás un enlazador, que es un programa que Rust utiliza para enlazar su salida compilada en un archivo. Es probable que ya tengas uno. Si recibes errores de enlazador, intenta instalar un compilador de C, que generalmente incluye un enlazador. Un compilador de C también será útil porque algunos paquetes comunes de Rust dependen del código C, de ahí la necesidad de un compilador de C.

En macOS, puedes obtener un compilador de C ejecutando el siguiente comando:

$ xcode-select --install

Los usuarios de Linux generalmente necesitan instalar GCC o Clang de acuerdo con la documentación de su distribución. Por ejemplo, si usas Ubuntu, puedes instalar el paquete build-essential.

Instalar rustup en Windows

En Windows, ve a instalar y sigue las instrucciones para instalar Rust. En algún momento de la instalación, recibirás un mensaje que explica la necesidad de instalar las herramientas de compilación de MSVC para Visual Studio 2013 o posterior.

Para obtener las herramientas de compilación, necesitas instalar Visual Studio 2022. Asegúrate de que las siguientes opciones estén seleccionadas:

  • "Desarrollo de escritorio con C++"
  • SDK de Windows 10 (o 11)
  • El paquete de idioma inglés, y cualquier otro paquete de idiomas que necesites

El resto de este libro utilizará comandos que deberían funcionar tanto en cmd.exe como en PowerShell. Si hay diferencias específicas, explicaremos cuál usar.

Solución de Problemas

Para verificar si Rust se instaló correctamente, abre una línea de comandos e introduce:

$ rustc --version

Deberías poder ver el número de versión, el hash de compromiso y la fecha de compromiso para la última versión estable en el siguiente formato:

rustc x.y.z (abcabcabc yyyy-mm-dd)

¡Si ves esta información, Rust está instalado correctamente!

Si no, verifica si Rust está incluido en tu variable del sistema %PATH%.

En CMD de Windows, usa:

> echo %PATH%

En PowerShell, usa:

> echo $env:Path

En Linux y macOS, usa:

$ echo $PATH

Si todo parece correcto pero Rust aún no funciona, hay muchos lugares donde obtener ayuda. Puedes ver cómo ponerte en contacto con otros entusiastas de Rust en la página de la comunidad.

Actualización y Desinstalación

Una vez que hayas instalado Rust a través de rustup, actualizar a la última versión es simple; solo ejecuta el siguiente script de actualización en tu línea de comandos correspondiente:

$ rustup update

Para desinstalar Rust y rustup, ejecuta el siguiente script de desinstalación en la línea de comandos:

$ rustup self uninstall

Documentación Local

La instalación también incluye una copia local de la documentación, que puedes leer sin conexión. Ejecuta rustup doc para abrir la documentación local en tu navegador.

¡Cada vez que estés inseguro sobre el uso y el comportamiento de tipos o funciones en la biblioteca estándar, consulta la documentación de la API!

Referencias