Kapitel 02: Einrichtung & Erstes Programm (Sicht für Anfänger)

In diesem Kapitel richten wir Schritt für Schritt deine Arbeitsumgebung ein und schreiben dein erstes lauffähiges Programm. Keine Sorge, wir gehen jeden Schritt gemeinsam durch!

1. Lernziele

Du wirst in diesem Abschnitt:

• Die Rust-Werkzeuge mit dem offiziellen Installationsprogramm rustup auf deinem Rechner einrichten.
• Deinen Code-Editor (VS Code) installieren und mit dem schlauen Helfer rust-analyzer ausstatten.
• Ein neues Projekt mit dem Werkzeug cargo erstellen.
• Ein Zufallszahlen-Programm schreiben, das eine Zahl von 1 bis 10 würfelt.

2. Die Installation mit rustup

Um Rust auf deinem Computer zu installieren, nutzen wir das Programm rustup. Du kannst dir rustup wie einen App-Store vorstellen, der speziell für die Programmiersprache Rust da ist. Es installiert für dich:

• Den Compiler (rustc): Das Programm, das deinen geschriebenen Text in die Sprache des Computers übersetzt.
• Das Build-System (cargo): Dein Bauleiter, der deine Projekte verwaltet und fremden Code herunterlädt.

Installationsschritte:

1. Öffne das Terminal (die Kommandozeile) deines Computers.
2. Tippe unter Linux oder macOS folgenden Befehl ein und drücke Enter:

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

3. Das Installationsprogramm fragt dich nach Optionen. Drücke einfach die Eingabetaste (Enter), um die empfohlene Standardinstallation (“1”) auszuwählen.
4. Sehr wichtig: Damit dein Terminal weiß, wo die neuen Werkzeuge liegen, musst du das Terminal entweder einmal schließen und neu öffnen oder folgenden Befehl eingeben:

   source $HOME/.cargo/env
   

Überprüfe die Installation, indem du nach der Version fragst:

rustc --version

Wenn dort etwas wie rustc 1.75.0 steht, war die Installation erfolgreich!

3. Der schlaue Editor: VS Code und rust-analyzer

Programmieren in einem normalen Texteditor ist mühsam, weil man Tippfehler erst bemerkt, wenn man das Programm startet. Wir richten uns deshalb einen Editor ein, der uns beim Tippen hilft.

1. Lade dir Visual Studio Code (VS Code) herunter und installiere es.
2. Öffne VS Code. Klicke links in der Seitenleiste auf das Symbol für Erweiterungen (das Symbol sieht aus wie vier Quadrate).
3. Suche nach rust-analyzer und klicke auf Installieren.

Tip

Der rust-analyzer liest deinen Code im Hintergrund sekündlich mit. Er zeichnet rote Wellenlinien unter Fehler (wie vergessene Semikolons oder falsche Variablennamen) und gibt dir direkt Tipps, wie du sie behebst. Er ist dein persönlicher Programmier-Assistent!

4. Ein neues Projekt erstellen

In Rust erstellen wir Projekte nicht manuell, sondern lassen das unseren Bauleiter Cargo machen.

Tippe folgenden Befehl in dein Terminal:

cargo new wuerfelspiel --bin

Das Flag --bin (kurz für binary) sagt Cargo, dass wir ein eigenständiges Programm erstellen wollen, das man direkt ausführen kann.

Cargo legt einen neuen Ordner an. Darin findest du:

• Cargo.toml: Die Einkaufs- und Einstellungsliste deines Projekts. Hier tragen wir später Zubehör ein.
• src/main.rs: Die Textdatei, in die wir unseren Rust-Code schreiben.

5. Code-Evolution: Das Würfelspiel schreiben

Öffne den Ordner wuerfelspiel in VS Code und öffne die Datei src/main.rs. Lösche den Inhalt und schreibe stattdessen folgenden Code hinein:

use rand::Rng; // 1. Wir aktivieren das Zufalls-Werkzeug (Rng)

fn main() {
    // 2. Wir würfeln eine Zahl von 1 bis inklusive 10
    let gewuerfelte_zahl = rand::thread_rng().gen_range(1..=10);
    
    // 3. Wir geben die Zahl auf dem Bildschirm aus
    println!("Du hast eine {} gewürfelt!", gewuerfelte_zahl);
}

Der erste Startversuch

Wechsle in deinem Terminal in den Projektordner (cd wuerfelspiel) und starte das Programm mit:

cargo run

Du wirst sehen, dass der Compiler meckert: “failed to resolve: use of undeclared crate or module ‘rand’”. Warum? Wir haben zwar gesagt: “Nutze das Werkzeug ‘rand’”, aber in unserer Einkaufsliste (Cargo.toml) steht dieses Werkzeug noch gar nicht drin!

Die Zutat einkaufen

Füge das Paket rand zu deinem Projekt hinzu, indem du folgenden Befehl im Terminal ausführst:

cargo add rand

Dieser Befehl trägt das Paket automatisch in deine Cargo.toml ein. Wenn du das Programm jetzt erneut mit cargo run startest, lädt Cargo das Paket aus dem Internet herunter, baut es ein und führt dein Programm aus. Du wirst ein Ergebnis sehen wie: Du hast eine 6 gewürfelt!

6. Key Takeaways

• rustup installiert und aktualisiert deine Rust-Werkzeuge.
• Cargo ist dein Bauleiter: cargo new erstellt Projekte, cargo add fügt Pakete hinzu und cargo run startet das Programm.
• Cargo.toml ist die Konfigurationsdatei für dein Projekt.
• Der rust-analyzer zeigt dir Programmierfehler sofort im Editor an.