adminslog/dokus/rust/rust-toolchain-msvc.md

Rust-Toolchain mit MSVC unter Windows einrichten

Dieser Artikel beschreibt die vollständige Einrichtung einer produktionsfähigen Rust-Toolchain mit MSVC (Microsoft Visual C++) unter Windows, einschließlich Erstellung einer .exe-Datei aus einem Beispielprogramm.

Inhalt

• Rust-Toolchain mit MSVC unter Windows einrichten
  • Inhalt
  • Voraussetzungen
  • 1. Rust installieren
  • 2. Visual Studio Build Tools installieren
    • Schritt-für-Schritt
  • 3. Umgebungsvariablen setzen (optional)
  • 4. Beispielprojekt erstellen
  • 5. Projekt kompilieren
    • Debug-Build (schnell, nicht optimiert)
    • Release-Build (optimiert, kleine .exe)
  • 6. Optional: .exe testen
  • 7. Troubleshooting
  • 8. Alternative: Toolchain in einem Offline-Installer vorbereiten
  • Zusammenfassung
  • Weiterführende Themen

---

Voraussetzungen

• Windows 10 oder 11 (64 Bit)
• Administratorrechte
• Mindestens 2 GB freier Speicherplatz

1. Rust installieren

Lade das offizielle Rust-Installationsprogramm herunter und führe es aus:

<https://rustup.rs>

Beim Setup:

• Toolchain wählen: default host triple: x86_64-pc-windows-msvc
• Folge dem Assistenten, um rustc, cargo und rustup zu installieren.

Verifiziere die Installation:

rustc --version
cargo --version

2. Visual Studio Build Tools installieren

Die Rust-Toolchain mit MSVC benötigt den "C++ Build Tools"-Teil von Visual Studio.

Schritt-für-Schritt

1. Lade den Visual Studio Installer:

   • https://visualstudio.microsoft.com/de/visual-cpp-build-tools/

2. Wähle bei der Installation:

   • ✅ C++ Build Tools
   • Und in der rechten Spalte:
     • ✅ "MSVC v14.x - VS 2022 C++ x64/x86-Buildtools"
     • ✅ "Windows 10 SDK" oder "Windows 11 SDK" (je nach Zielsystem)
     • ✅ "C++ CMake-Tools für Windows" (optional für CMake-Projekte)

3. Installiere alles und starte das System neu, falls verlangt.

3. Umgebungsvariablen setzen (optional)

Falls du die Buildtools über Kommandozeile verwenden willst, öffne:

"C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvars64.bat"

Das setzt temporär alle notwendigen Umgebungsvariablen für den Build-Prozess.

4. Beispielprojekt erstellen

cargo new hello_world
cd hello_world

Beispielcode in src/main.rs:

fn main() {
    println!("Hallo Welt – kompiliert mit MSVC!");
}

5. Projekt kompilieren

Debug-Build (schnell, nicht optimiert)

cargo build

Release-Build (optimiert, kleine .exe)

cargo build --release

Die fertige .exe liegt unter:

.\target\release\hello_world.exe

6. Optional: .exe testen

.\target\release\hello_world.exe

7. Troubleshooting

• Fehlermeldung link.exe not found?
  → Build-Tools sind nicht korrekt installiert (siehe Schritt 2)

• Fehlermeldung zu fehlendem SDK?
  → Stelle sicher, dass du das passende Windows SDK mit installiert hast

• MSVC und GNU Toolchain gleichzeitig installiert?
  → Du kannst über rustup zwischen beiden wechseln:

rustup show
rustup default stable-x86_64-pc-windows-msvc

8. Alternative: Toolchain in einem Offline-Installer vorbereiten

Wenn du das Setup auf mehreren Rechnern ohne Internetzugang durchführen möchtest, siehe separater Artikel zur Erstellung eines Installationsmediums.

Zusammenfassung

Komponente	Aufgabe
Rustup	Verwaltung von Toolchains
Cargo	Buildsystem und Paketmanager
MSVC Build Tools	C++-Compiler/Linker für Windows
vcvars64.bat	Aktiviert Build-Umgebung
cargo build	Erstellt .exe mit Rust und MSVC

Weiterführende Themen

• Einbindung von Ressourcen und Icons in die .exe
• Verwendung von cc/bindgen für C-Bindings
• Cross-Kompilierung mit x86_64-pc-windows-gnu oder Linux-Zielsystemen
• Automatisierter Build via Makefile oder PowerShell