Tutorials

Visual Studio Code: „#include errors detected. Please update your includePath“ – Gelöst (C/C++)

Melden

Dieser Fehler ist einer der häufigsten Frustrationsmomente bei der C- und C++-Entwicklung in Visual Studio Code. Er bedeutet einfach, dass die C/C++-Erweiterung (IntelliSense) nicht weiß, wo sich die Standard-Header-Dateien (wie <iostream> oder <stdio.h>) oder deine eigenen .h-Dateien auf deiner Festplatte befinden.

Oft lässt sich das Programm über das Terminal fehlerfrei kompilieren, aber VS Code zeigt trotzdem eine rote Wellenlinie an. In dieser Anleitung lösen wir das Problem Schritt für Schritt.

Schritt 0: Voraussetzung prüfen (Compiler installiert?)

VS Code ist nur ein Editor, kein Compiler. Stelle sicher, dass du einen Compiler (z. B. MinGW/GCC unter Windows, Xcode/Clang auf macOS oder GCC unter Linux) installiert hast.

Öffne das Terminal in VS Code (Strg + `) und tippe:

g++ --version
# oder
gcc --version

Wird hier ein Fehler angezeigt, musst du zuerst einen Compiler installieren und diesen zu deinen System-Umgebungsvariablen (PATH) hinzufügen.

Lösung 1: Den Compiler-Pfad automatisch setzen (Der schnellste Weg)

IntelliSense findet die Header meistens automatisch, sobald du ihm sagst, welchen Compiler du verwendest.

  1. Drücke in VS Code die Tastenkombination Strg + Umschalt + P (macOS: Cmd + Shift + P), um die Befehlspalette zu öffnen.
  2. Tippe folgendes ein und wähle es aus:
    C/C++: Edit Configurations (UI) (Konfigurationen bearbeiten (UI))
  3. Scrolle zum Feld Compiler path (Compiler-Pfad).
  4. Klicke auf das Dropdown-Menü. VS Code durchsucht dein System und schlägt dir gefundene Compiler vor.
    • Windows (MinGW): z. B. C:/msys64/ucrt64/bin/g++.exe oder ähnlich.
    • Linux: meist /usr/bin/gcc oder /usr/bin/g++.
    • macOS: meist /usr/bin/clang++.
  5. Wähle deinen Compiler aus.
  6. Scrolle etwas weiter runter zu IntelliSense mode und wähle den passenden Modus (z. B. windows-gcc-x64 oder linux-gcc-x64).
  7. Schließe den Tab. Die roten Wellenlinien sollten nach wenigen Sekunden verschwinden.

Lösung 2: Die Konfigurationsdatei manuell anpassen (c_cpp_properties.json)

Falls die UI-Methode nicht geholfen hat, kannst du die Konfigurationsdatei direkt bearbeiten:

  1. Drücke wieder Strg + Umschalt + P.
  2. Wähle diesmal: C/C++: Edit Configurations (JSON).
  3. Es öffnet sich eine Datei namens c_cpp_properties.json im Ordner .vscode.
  4. Passe den Inhalt wie im folgenden Beispiel an (ersetze den compilerPath mit deinem tatsächlichen Pfad):
{
    "configurations": [
        {
            "name": "Win32",
            "includePath": [
                "${workspaceFolder}/**"
            ],
            "defines": [
                "_DEBUG",
                "UNICODE",
                "_UNICODE"
            ],
            "compilerPath": "C:/msys64/mingw64/bin/g++.exe",
            "cStandard": "c17",
            "cppStandard": "c++17",
            "intelliSenseMode": "windows-gcc-x64"
        }
    ],
    "version": 4
}

*Hinweis für ${workspaceFolder}/**:* Dies sorgt dafür, dass IntelliSense rekursiv alle Unterordner deines aktuellen Projekts nach Header-Dateien durchsucht.

Lösung 3: Eigene Header-Dateien werden nicht gefunden

Wenn der Fehler bei deinen eigenen Dateien auftritt (z. B. #include "meineDatei.h"):

  1. Liegen deine Header-Dateien in einem Unterordner (z. B. in einem Ordner namens include/ oder headers/)?
  2. Öffne die c_cpp_properties.json (wie in Lösung 2 beschrieben).
  3. Füge den spezifischen Ordner zum includePath-Array hinzu:
"includePath": [
    "${workspaceFolder}/**",
    "${workspaceFolder}/include"
],

Schneller Trick: Die Glühbirne (Quick Fix) nutzen

  1. Fahre mit der Maus über die rote Wellenlinie beim fehlerhaften #include.
  2. Klicke auf die erscheinende gelbe Glühbirne.
  3. Wähle "Edit includePath setting" aus.
  4. VS Code leitet dich direkt an die richtige Stelle weiter, an der der fehlende Pfad eingetragen werden muss.

Zusammenfassung

Das Problem entsteht fast immer, weil die C/C++-Erweiterung den installierten Compiler nicht kennt. Sobald der Compiler-Pfad in den C/C++-Einstellungen hinterlegt ist, zieht sich VS Code die Standard-Header automatisch und die Fehlermeldung verschwindet.

0