Comenzar

¡Configura rápidamente un entorno de desarrollo para Rust y desarrolla una pequeña aplicación!

Instalar Rust

Puedes probar Rust online en el Rust Playground sin instalar nada en tu ordenador.

Prueba Rust sin instalar

Rustup: la herramienta de instalación y gestión de versiones de Rust

La forma más común de instalar Rust es usando una herramienta llamada Rustup, que es un instalador y gestor de versiones.

Parece que estás usando macOS, GNU/Linux u otra variante de Unix. Para descargar Rustup e instalar Rust, ejecuta el siguiente comando en tu terminal y sigue las instrucciones que aparecen en pantalla.

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

Parece que estás usando Windows. Para empezar a usar Rust, descarga el instalador, ejecútalo y sigue las instrucciones que aparecen en pantalla. Es posible que tengas que instalar las Visual Studio C++ Build tools cuando se te pida. Si no estás usando Windows, ve a "Other Installation Methods"

Subsistema de Windows para Linux

Si utilizas el Subsistema de Windows para Linux (WSL), ejecuta el siguiente comando en tu terminal y sigue las instrucciones que aparecen en pantalla para instalar Rust.

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

Rust funciona en Windows, Linux, macOS, FreeBSD and NetBSD. Si estás en una de estas plataformas y ves esto, por favor, informa de un problema con los siguientes valores:

navigator.platform: MacIntel
navigator.appVersion: 5.0 (Macintosh)

Informar de un problema

Para instalar Rust, si usas Unix,
ejecuta el siguiente comando en tu terminal y sigue las instrucciones que aparecen en pantalla.

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

Si usas Windows,
descarga y ejecuta rustup‑init.exe y sigue las instrucciones que aparecen en pantalla.

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

Si usas Windows,
descarga y ejecuta rustup‑init.exe y sigue las instrucciones que aparecen en pantalla.


¿Está Rust actualizado?

Rust recibe actualizaciones muy frecuentemente. Si instalaste Rustup hace tiempo, es posible que tu versión de Rust esté desactualizada. Consigue la última versión de Rust ejecutando `rustup update`.


Aprende más sobre la instalación

Cargo: la herramienta de Rust para compilar y gestionar paquetes

Cuando instalas Rustup también obtienes la última versión estable de la herramienta de compilación y gestión de paquetes de Rust, conocida como Cargo. Cargo hace un montón de cosas:

  • construye tu proyecto con cargo build
  • ejecuta tu proyecto con cargo run
  • ejecuta los tests de tu proyecto con cargo test
  • genera la documentación de tu proyecto con cargo doc
  • publica una biblioteca en crates.io con cargo publish

Para verificar que tienes Rust y Cargo instalados, puedes ejecutar esto en tu terminal favorito:

cargo --version

Lee el libro de cargo

Otras herramientas

Rust tiene soporte en muchos editores:

Generar un nuevo proyecto

Escribamos una pequeña aplicación con nuestro nuevo entorno de desarrollo de Rust. Para empezar, usaremos Cargo para crear un nuevo proyecto. En tu terminal preferido ejecuta:

cargo new hello-rust

Esto generará un nuevo directorio llamado hello-rust con los siguientes archivos:

hello-rust
|- Cargo.toml
|- src
  |- main.rs

Cargo.toml es el archivo de manifiesto de Rust. Es donde mantenemos los metadatos del proyecto, así como la declaración de dependencias.

src/main.rs es donde escribimos el código de nuestra aplicación.


cargo new genera un proyecto de "Hello, world" para nosotros. Podemos ejecutar el programa si nos movemos al nuevo directorio recién creado ejecutando en tu terminal:

cargo run

Deberías ver esto en tu terminal:

$ cargo run
   Compiling hello-rust v0.1.0 (/Users/ag_dubs/rust/hello-rust)
    Finished dev [unoptimized + debuginfo] target(s) in 1.34s
     Running `target/debug/hello-rust`
Hello, world!

Añadir dependencias

Añadamos una dependencia a nuestra aplicación. Puedes encontrar toda clase de bibliotecas en crates.io, el registro de paquetes para proyectos Rust. En Rust normalmente nos referimos a los paquetes como "crates".

En este proyecto usaremos una crate llamada ferris-says.

En nuestro archivo Cargo.toml añadiremos esta información (que copiamos de la página de la crate):

[dependencies]
ferris-says = "0.2"

Ahora podemos ejecutar:

cargo build

... y Cargo instalará la dependencia por nosotros.

Verás que al ejecutar ese comando se ha creado un nuevo archivo, Cargo.lock. Este archivo contiene una lista de las versiones exactas de todas las dependencias usadas en local.

Para usar esta dependencia podemos abrir main.rs, borrar todo su contenido (solo es un ejemplo), y añadir esta línea:

use ferris_says::say;

Esta línea indica que ahora podemos usar la función say que la crate ferris-says exporta para nosotros.

Una pequeña aplicación en Rust

Ahora escribamos una pequeña aplicación con nuestra nueva dependencia. En nuestro main.rs, añade el siguiente código:

use ferris_says::say; // from the previous step
use std::io::{stdout, BufWriter};

fn main() {
    let stdout = stdout();
    let message = String::from("Hello fellow Rustaceans!");
    let width = message.chars().count();

    let mut writer = BufWriter::new(stdout.lock());
    say(message.as_bytes(), width, &mut writer).unwrap();
}
    

Una vez guardamos los cambios, podemos ejecutar la aplicación escribiendo:

cargo run

Asumiendo que todo fue bien, deberías ver que tu aplicación escribe esto en la pantalla:

----------------------------
< Hello fellow Rustaceans! >
----------------------------
              \
               \
                 _~^~^~_
             \) /  o o  \ (/
               '_   -   _'
               / '-----' \
    

¡Aprende más!

¡Ya eres un Rustacean! ¡Bienvenido! Estamos muy contentos de tenerte con nosotros. Cuando estés listo, visita nuestra página de Aprender, donde encontrarás varios libros que te ayudaran a continuar tu aventura con Rust

¡aprende más!

¿Quién es este cangrejo, Ferris?

Ferris es la mascota no oficial de la comunidad de Rust. Muchos programadores de Rust se llaman a sí mismos "Rustaceans", un juego de palabras con "crustacean" (crustáceo). En inglés preferimos referirnos a Ferris con los pronombres neutros "they", "them" en vez de los pronombres con género.

El nombre de Ferris es un juego de palabras con el adjetivo "ferrous" (férreo) que significa "que es de hierro o lo contiene". Dado que el óxido ("rust" en inglés) se forma a menudo sobre el hierro, parece un origen divertido para el nombre de nuestra mascota.

Puedes encontrar más imágenes de Ferris en rustacean.net. Un gif de Ferris andando de lado