Configurando tu Entorno de Desarrollo Rust

Antes de comenzar a programar en Rust, necesitas configurar tu entorno de desarrollo correctamente. Esta guía te llevará paso a paso a través del proceso de instalación y configuración.

Instalación de Rust

Usando rustup (Recomendado)

rustup es la herramienta oficial para instalar y gestionar Rust. Es la forma más fácil y recomendada de instalar Rust.

En macOS, Linux y otros sistemas Unix:

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

En Windows:

Ve a https://rustup.rs/
Descarga rustup-init.exe
Ejecuta el instalador y sigue las instrucciones

Verificando la Instalación

Después de instalar, reinicia tu terminal y verifica que todo esté correctamente instalado:

# Verificar que rustc (el compilador) está instalado
rustc --version

# Verificar que cargo (gestor de paquetes) está instalado  
cargo --version

# Verificar que rustup está instalado
rustup --version

Deberías ver algo como:

rustc 1.75.0 (82e1608df 2023-12-21)
cargo 1.75.0 (1d8b05cdd 2023-11-20)
rustup 1.26.0 (5af9b9484 2023-04-05)

Herramientas Esenciales

Rust viene con varias herramientas integradas que te ayudarán en el desarrollo:

rustc - El Compilador

rustc es el compilador de Rust. Aunque normalmente usarás cargo, es útil conocer cómo compilar archivos individuales:

# Compilar un archivo simple
rustc main.rs

# Compilar con optimizaciones
rustc -O main.rs

# Ver opciones de compilación
rustc --help

cargo - Gestor de Paquetes y Herramienta de Construcción

cargo es el sistema de construcción y gestor de paquetes de Rust:

# Crear un nuevo proyecto
cargo new mi_proyecto
cd mi_proyecto

# Crear un nuevo proyecto como librería
cargo new mi_libreria --lib

# Construir el proyecto
cargo build

# Construir con optimizaciones (release)
cargo build --release

# Ejecutar el proyecto
cargo run

# Ejecutar tests
cargo test

# Verificar que el código compila sin construir
cargo check

# Actualizar dependencias
cargo update

rustup - Gestor de Versiones

rustup te permite gestionar múltiples versiones de Rust:

# Ver versiones instaladas
rustup toolchain list

# Instalar una versión específica
rustup toolchain install 1.70.0

# Cambiar versión por defecto
rustup default stable

# Actualizar Rust
rustup update

# Ver información del sistema
rustup show

rustfmt - Formateador de Código

rustfmt formatea automáticamente tu código Rust según el estilo oficial:

# Formatear un archivo
rustfmt src/main.rs

# Formatear todo el proyecto
cargo fmt

# Verificar formato sin cambiar archivos
cargo fmt -- --check

clippy - Linter para Mejores Prácticas

clippy es un linter que te ayuda a escribir mejor código Rust:

# Instalar clippy (viene por defecto con rustup)
rustup component add clippy

# Ejecutar clippy en tu proyecto
cargo clippy

# Clippy con correcciones automáticas
cargo clippy --fix

Configuración del Editor

Visual Studio Code

VS Code es una excelente opción para Rust:

Instala la extensión rust-analyzer:
- Ve a extensiones (Ctrl+Shift+X)
- Busca “rust-analyzer”
- Instala la extensión oficial
Extensiones útiles adicionales:
- “CodeLLDB” para debugging
- “Better TOML” para archivos Cargo.toml
- “Error Lens” para mostrar errores inline

Configuración recomendada para VS Code

Crea .vscode/settings.json en tu proyecto:

{
    "rust-analyzer.check.command": "clippy",
    "rust-analyzer.cargo.features": "all",
    "editor.formatOnSave": true,
    "[rust]": {
        "editor.defaultFormatter": "rust-lang.rust-analyzer"
    }
}

Otros Editores Populares

IntelliJ IDEA/CLion: Plugin IntelliJ Rust
Vim/Neovim: rust.vim + coc-rust-analyzer
Emacs: rust-mode + lsp-mode
Sublime Text: LSP-rust-analyzer

Tu Primer Proyecto

Vamos a crear tu primer proyecto Rust para probar que todo funciona:

# Crear nuevo proyecto
cargo new hola_mundo
cd hola_mundo

Esto crea la siguiente estructura:

hola_mundo/
├── Cargo.toml
└── src/
    └── main.rs

Cargo.toml (manifiesto del proyecto):

[package]
name = "hola_mundo"
version = "0.1.0"
edition = "2021"

[dependencies]

src/main.rs (código fuente):

fn main() {
    println!("¡Hola, mundo!");
}

Ejecutar el Proyecto

# Compilar y ejecutar
cargo run

Deberías ver:

   Compiling hola_mundo v0.1.0 (/path/to/hola_mundo)
    Finished dev [unoptimized + debuginfo] target(s) in 0.50s
     Running `target/debug/hola_mundo`
¡Hola, mundo!

Configuración Avanzada

Targets de Compilación

Rust puede compilar para múltiples plataformas:

# Ver targets disponibles
rustup target list

# Instalar target específico
rustup target add x86_64-pc-windows-gnu

# Compilar para target específico
cargo build --target x86_64-pc-windows-gnu

Variables de Entorno Útiles

# Ubicación de instalación de Rust
export RUSTUP_HOME="$HOME/.rustup"
export CARGO_HOME="$HOME/.cargo"

# Agregar cargo bin al PATH
export PATH="$CARGO_HOME/bin:$PATH"

# Configurar nivel de log para cargo
export CARGO_LOG=info

# Habilitar backtrace completo en panic
export RUST_BACKTRACE=1

Configuración de Cargo

Puedes configurar cargo globalmente en ~/.cargo/config.toml:

[build]
# Usar linker más rápido en macOS
rustflags = ["-C", "link-arg=-fuse-ld=lld"]

[cargo-new]
# Template por defecto para nuevos proyectos
vcs = "git"

[registries]
# Configurar registries alternativos

Solución de Problemas Comunes

Error: “linker not found”

En Ubuntu/Debian:

sudo apt install build-essential

En macOS:

xcode-select --install

Problemas con SSL/TLS

# Actualizar certificados
rustup self update

Espacio en Disco

# Limpiar archivos de compilación
cargo clean

# Limpiar cache de cargo
cargo install cargo-cache
cargo cache --autoclean

Próximos Pasos

Con tu entorno configurado, estás listo para:

Aprender la sintaxis básica de Rust
Escribir tu primer programa real
Explorar el ecosistema de crates (librerías)
Contribuir a proyectos open source

Recursos Adicionales

Documentación oficial: https://doc.rust-lang.org/
Rust Playground: https://play.rust-lang.org/ (para probar código online)
Rustlings: Ejercicios interactivos para aprender
Rust by Example: https://doc.rust-lang.org/rust-by-example/

¡Felicidades! Ahora tienes un entorno de desarrollo Rust completamente funcional. En el próximo capítulo, aprenderemos la sintaxis básica del lenguaje.

Output

$ cargo run