Zum Hauptinhalt springen

Rust installieren

Installation​

Der erste Schritt zur Nutzung von Rust ist die Installation. Wir werden Rust über rustup, ein Kommandozeilenwerkzeug zur Verwaltung von Rust-Versionen und zugehörigen Tools, herunterladen. Für den Download ist eine Internetverbindung erforderlich.

Hinweis: Wenn Sie aus irgendeinem Grund rustup nicht verwenden möchten, finden Sie auf der Seite mit anderen Installationsmethoden für Rust weitere Installationsmöglichkeiten.

Die folgenden Schritte installieren die neueste stabile Version des Rust-Compilers. Unterschiedliche Versionen können leicht variieren, da Rust häufig Fehlermeldungen und Warnungen verbessert. Dennoch sollten alle neuesten stabilen Versionen von Rust, die durch diese Schritte installiert werden, in der Lage sein, alle Inhalte dieses Buches auszuführen.

Kommandozeilennotation​

In diesem Buch, insbesondere in diesem Kapitel, werden einige Befehle angezeigt, die im Terminal verwendet werden. Alle Zeilen, die Sie in Ihr Terminal eingeben sollen, beginnen mit $. Sie müssen das $-Zeichen nicht eingeben; es dient dazu, den Beginn jedes Befehls anzuzeigen. Zeilen, die nicht mit $ beginnen, zeigen in der Regel die Ausgabe des vorherigen Befehls. PowerShell-spezifische Beispiele verwenden > statt $.

rustup auf Linux oder macOS installieren​

Wenn Sie Linux oder macOS verwenden, öffnen Sie ein Terminal und geben Sie den folgenden Befehl ein:

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

Dieser Befehl lädt ein Skript herunter und startet die Installation des rustup-Tools, das die neueste stabile Version von Rust installiert. Während des Vorgangs werden Sie möglicherweise nach Ihrem Passwort gefragt. Wenn die Installation erfolgreich ist, sehen Sie folgende Nachricht:

Rust is installed now. Great!

Zusätzlich benötigen Sie einen Linker, ein Programm, das Rust verwendet, um seine kompilierten Ausgaben in eine Datei zu verknüpfen. Wahrscheinlich haben Sie bereits einen. Wenn Sie Linker-Fehler erhalten, versuchen Sie, einen C-Compiler zu installieren, der normalerweise einen Linker enthält. Ein C-Compiler wird auch nützlich sein, da einige gängige Rust-Pakete von C-Code abhängen, daher die Notwendigkeit eines C-Compilers.

Auf macOS können Sie einen C-Compiler mit folgendem Befehl installieren:

$ xcode-select --install

Linux-Benutzer müssen in der Regel GCC oder Clang gemäß der Dokumentation ihrer Distribution installieren. Zum Beispiel können Sie auf Ubuntu das Paket build-essential installieren.

rustup auf Windows installieren​

Auf Windows gehen Sie auf install und folgen Sie den Anweisungen zur Installation von Rust. Irgendwann während der Installation erhalten Sie eine Nachricht, die die Notwendigkeit der Installation der MSVC-Build-Tools für Visual Studio 2013 oder später erklärt.

Um die Build-Tools zu erhalten, müssen Sie Visual Studio 2022 installieren. Achten Sie darauf, dass folgende Optionen ausgewählt sind:

  • "Desktop Development with C++"
  • Windows 10 (oder 11) SDK
  • Das englische Sprachpaket und alle weiteren Sprachpakete, die Sie benötigen

Der Rest dieses Buches verwendet Befehle, die sowohl in cmd.exe als auch in PowerShell funktionieren sollten. Wenn es spezifische Unterschiede gibt, werden wir erklären, welche zu verwenden sind.

Fehlerbehebung​

Um zu überprüfen, ob Rust korrekt installiert wurde, öffnen Sie eine Kommandozeile und geben Sie ein:

$ rustc --version

Sie sollten in der Lage sein, die Versionsnummer, den Commit-Hash und das Commit-Datum für die neueste stabile Version im folgenden Format zu sehen:

rustc x.y.z (abcabcabc yyyy-mm-dd)

Wenn Sie diese Informationen sehen, ist Rust erfolgreich installiert!

Wenn nicht, überprüfen Sie, ob Rust in Ihrer %PATH%-Systemvariable enthalten ist.

Auf Windows CMD verwenden Sie:

> echo %PATH%

Auf PowerShell verwenden Sie:

> echo $env:Path

Auf Linux und macOS verwenden Sie:

$ echo $PATH

Wenn alles korrekt aussieht, Rust aber immer noch nicht funktioniert, gibt es viele Möglichkeiten, Hilfe zu erhalten. Sie können sehen, wie Sie mit anderen Rust-Enthusiasten in Kontakt treten können, auf der Community-Seite.

Aktualisieren und Deinstallieren​

Nachdem Sie Rust über rustup installiert haben, ist das Update auf die neueste Version einfach; führen Sie einfach das folgende Update-Skript in Ihrer entsprechenden Befehlszeile aus:

$ rustup update

Um Rust und rustup zu deinstallieren, führen Sie das folgende Deinstallations-Skript in der Befehlszeile aus:

$ rustup self uninstall

Lokale Dokumentation​

Die Installation enthält auch eine lokale Kopie der Dokumentation, die Sie offline lesen können. Führen Sie rustup doc aus, um die lokale Dokumentation in Ihrem Browser zu öffnen.

Immer wenn Sie unsicher sind über die Verwendung und das Verhalten von Typen oder Funktionen in der Standardbibliothek, überprüfen Sie die API-Dokumentation!

Referenzen​