Tutorials

Tutorial: GCC-Fehler in Visual Studio Code lösen

Melden

Hier ist ein ausführliches Tutorial, wie du den Fehler "The term 'gcc' is not recognized..." in Visual Studio Code behebst.

Wenn du versuchst, C- oder C++-Code in Visual Studio Code zu kompilieren und die Fehlermeldung erhältst, dass der Begriff „gcc“ nicht erkannt wird, bedeutet das, dass der Compiler entweder nicht installiert ist oder dass Windows nicht weiß, wo er zu finden ist (der Pfad fehlt in den Umgebungsvariablen).

Folge diesen Schritten, um das Problem dauerhaft zu lösen.

Schritt 1: Überprüfen, ob GCC installiert ist

Bevor wir den Pfad anpassen, müssen wir sicherstellen, dass ein Compiler auf deinem System vorhanden ist.

  1. Drücke Windows-Taste + R, tippe cmd ein und drücke Enter.
  2. Gib gcc --version ein.
  3. Wenn dort steht "Der Befehl 'gcc' ist falsch geschrieben...", ist er nicht installiert. Gehe zu Schritt 2. Wenn eine Versionsnummer erscheint, gehe direkt zu Schritt 3.

Schritt 2: GCC installieren (via MSYS2)

Die modernste Methode, GCC unter Windows zu installieren, ist über MSYS2.

  1. Gehe auf die Website msys2.org und lade den Installer herunter.
  2. Installiere das Programm (standardmäßig unter C:\msys64).
  3. Nach der Installation öffnet sich ein Terminal (MSYS2 UCRT64). Gib dort folgenden Befehl ein, um den GCC-Compiler-Stack zu installieren:
    pacman -S --needed base-devel mingw-w64-ucrt-x86_64-toolchain
  4. Bestätige alle Abfragen mit der Eingabetaste (Enter), um die Standardauswahl zu installieren.

Schritt 3: Den Pfad zur Umgebungsvariable hinzufügen (Wichtig!)

Damit VS Code den Befehl gcc überall erkennt, muss der Ordner "bin" des Compilers in den Windows-Systemvariablen hinterlegt werden.

  1. Suche in der Windows-Suche nach "Systemumgebungsvariablen bearbeiten" und öffne das Ergebnis.
  2. Klicke im Reiter "Erweitert" unten auf den Button "Umgebungsvariablen...".
  3. Suche unter "Systemvariablen" die Zeile "Path" (oder "Pfad"), markiere sie und klicke auf "Bearbeiten...".
  4. Klicke auf "Neu" und füge den Pfad zu deinem Compiler hinzu. Wenn du MSYS2 wie oben installiert hast, lautet der Pfad meistens: C:\msys64\ucrt64\bin (Falls du ein älteres MinGW nutzt, könnte es C:\MinGW\bin sein).
  5. Bestätige alle drei Fenster nacheinander mit OK.

Schritt 4: Visual Studio Code neu starten

Dies ist ein entscheidender Schritt. Änderungen an den Umgebungsvariablen werden von bereits geöffneten Programmen oft nicht sofort erkannt.

  1. Schließe Visual Studio Code komplett.
  2. Starte Visual Studio Code neu.

Schritt 5: Erfolgskontrolle

  1. Öffne ein neues Terminal in Visual Studio Code (Strg + ö oder Terminal -> Neues Terminal).
  2. Gib folgenden Befehl ein:
    gcc --version
  3. Du solltest nun eine Ausgabe erhalten, die etwa so aussieht: gcc (Rev...) 13.x.x.

Der Fehler ist nun behoben!

Zusätzlicher Tipp für VS Code:

Installiere in VS Code die Erweiterung "C/C++" von Microsoft, falls du das noch nicht getan hast. Drücke dazu Strg + Umschalt + X und suche nach "C/C++". Dies gibt dir IntelliSense (Autovervollständigung) und bessere Debugging-Möglichkeiten.

0