Comienza
¡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 instalarRustup: 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 | shParece 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 | shRust 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:
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
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.rsCargo.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.3.1"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, 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.
