Iniziare con Cargo in Rust: Guida per Principianti

Iniziare con Cargo in Rust: Guida per Principianti

Cargo è lo strumento di compilazione e il gestore di pacchetti predefinito per Rust. Ti aiuta a compilare il tuo codice, scaricare librerie (chiamate dipendenze) e mantenere tutto organizzato.

1. Cos'è Cargo?

Quando usi Cargo, non devi compilare il tuo codice manualmente con rustc. Cargo rende tutto più semplice, specialmente nei progetti più grandi. Puoi:

  • Compilare il tuo codice
  • Aggiungere librerie esterne (dipendenze)
  • Eseguire il tuo programma
  • Controllare la presenza di errori di compilazione

2. Controlla se Cargo è installato

Se hai installato Rust usando il metodo ufficiale (rustup), Cargo è già installato.

Per verificare, esegui questo comando nel tuo terminale:

$ cargo --version

Se vedi un numero di versione, sei pronto!

3. Crea un nuovo progetto

Ora, creiamo un nuovo progetto Rust usando Cargo:

$ cargo new hello_cargo
$ cd hello_cargo

Questo crea una cartella chiamata hello_cargo con due elementi importanti all'interno:

  • Cargo.toml – un file di configurazione per il tuo progetto
  • src/main.rs – il file principale del codice

4. Esplora la struttura del progetto

Il file src/main.rs contiene un semplice programma:

fn main() {
    println!("Hello, world!");
}

Cargo inizializza anche Git e crea un file .gitignore se non ti trovi già in un repository Git.

5. Compila ed esegui con Cargo

Ora puoi compilare il tuo progetto usando:

$ cargo build

Questo compila il tuo codice e crea un eseguibile nella cartella target/debug.

Per eseguire il programma:

$ ./target/debug/hello_cargo

6. Usa cargo run (Più veloce)

Invece di compilare e poi eseguire separatamente, puoi usare:

$ cargo run

Questo compila il codice (se necessario) ed esegue il programma in un unico passaggio.

7. Controlla gli errori con cargo check

Se vuoi solo controllare il tuo codice senza compilare un binario completo, usa:

$ cargo check

È molto più veloce durante la fase di sviluppo!

8. Compila per il rilascio (Release)

Quando il tuo progetto è pronto per essere condiviso o pubblicato, usa la modalità release:

$ cargo build --release

Il binario ottimizzato si troverà nella cartella target/release. È più veloce rispetto alle versioni di debug, ma richiede più tempo per la compilazione.

9. Perché usare Cargo?

Anche i piccoli progetti traggono beneficio da Cargo. Ma quando il tuo codice cresce o necessita di librerie, Cargo diventa essenziale. Infatti:

  • Gestisce le dipendenze automaticamente
  • Organizza i file in modo standard
  • Funziona allo stesso modo su Windows, macOS e Linux

10. Riassunto

  • Usa cargo new per iniziare un progetto
  • Usa cargo build per compilare
  • Usa cargo run per compilare ed eseguire
  • Usa cargo check per controllare gli errori
  • Usa cargo build --release per il codice ottimizzato

Una volta iniziato a usare Cargo, apprezzerai quanto semplifichi lo sviluppo in Rust!

Per saperne di più, visita la documentazione ufficiale di Cargo.

Comments

Popular posts from this blog

How to Install Ubuntu 24.04 WSL on Windows 10 and 11

Introduction to Rust: Writing Your First "Hello, World!"

Getting Started with Cargo in Rust: A Beginner-Friendly Guide