Installation
Laden Sie das Windows-x64-Archiv herunter und entpacken Sie es in ein beliebiges Verzeichnis. CrucibleCpp ist ein statisch gelinktes Einzeldatei-Programm; eine Laufzeitumgebung muss nicht installiert werden.
Schnellstart
Suchen Sie im PATH nach g++.exe. Ersetzen Sie dann einfach Ihr bisheriges g++ -E:
Wenn der Ziel-GCC nicht im PATH liegt, geben Sie ihn mit --gcc explizit an:
GCC wählen
CrucibleCpp nutzt die vordefinierten Makros des Ziel-GCC, die__has_* Daten und die Include-Suchpfade. Verwenden Sie kein GCC-15-Profil, um Header von GCC 14 zu verarbeiten.
| Methode | Verhalten |
|---|---|
--gcc-version=13|14|15 | Sucht im PATH den höchsten unterstützten Compiler, der zur Hauptversion passt |
--gcc <g++.exe> | Verwendet den angegebenen Compiler direkt und liest dessen Version und Include-Pfade |
| Nicht angegeben | Durchsucht den PATH und wählt standardmäßig die höchste unterstützte Version (15 → 14 → 13) |
--gcc, und verlassen Sie sich nicht auf einen festen Laufwerksbuchstaben.Unterstützte Standardprofile:
Typische Kommandozeilen
| Parameter | Wirkung |
|---|---|
-P | Keine Line-Marker ausgeben |
-o <file> | Ausgabedatei |
-I <dir> | Include-Verzeichnis hinzufügen |
-isystem <dir> | System-Header-Verzeichnis |
-D / -U | Makros definieren / aufheben |
-include <file> | Erzwungenes Inkludieren |
-MD -MF -MT | Make-/CMake-Abhängigkeitsdateien erzeugen |
-finput-charset / -fexec-charset | Eingabe- / Ausführungszeichensatz |
--embed-dir <dir> | #embed Suchverzeichnis |
--analysis-json <file> | Include-Graph, Macro-Trace und PCH-Einträge ausgeben |
PCH
GCCs g++ -E nutzt .gchnicht; PCH wird erst beim eigentlichen Kompilieren verwendet. CrucibleCpp liest standardmäßig die Header-Quellen und kann extern erzeugte PCHs optional validieren, registrieren und cachen.
PCH-Cache aktivieren:
Das Cache-Manifest zeichnet Compiler-Pfad, Version, Compiler-Hash und Options-Hash auf. PCHs von GCC 13/14/15 kollidieren nicht miteinander.
Diagnosen
Standardmäßig werden GCC-artige Quellzeilen und Caret ausgegeben. Das lässt sich abschalten oder anpassen:
Unterstützt #pragma GCC diagnostic push/pop/ignored/warning/error und #pragma GCC system_header. Header aus -isystem unterdrücken standardmäßig normale Warnungen;-Wsystem-headers macht sie wieder sichtbar.
Fehlerbehebung
Standardbibliotheks-Header nicht gefunden
Der Ziel-Compiler ist nicht im PATH. Geben Sie ihn mit --gcc an, oder fügen Sie bin zum PATH hinzu. Alternativ können Sie -isystem explizit übergeben.
Falsche GCC-Version gewählt
Fixieren Sie die Hauptversion mit --gcc-version=13|14|15 , oder verweisen Sie mit --gcc gezielt auf eine bestimmte g++.exe. Mischen Sie kein Zielprofil mit Headern einer anderen Version.
PCH-Cache meldet corrupt
PCH und aktueller Compiler bzw. die Optionen passen nicht zusammen, oder die Datei ist beschädigt. Löschen Sie den passenden Cache-Eintrag und erzeugen Sie ihn neu; alternativ deaktivieren Sie den PCH-Cache und lassen Sie die Header-Quellen lesen.
Die Ausgabe lässt sich nicht mit GCC kompilieren
Prüfen Sie zuerst, ob Vorverarbeitung und Kompilierung dieselbe GCC-Version und -std. Kompilieren Sie dann die von CrucibleCpp erzeugte „.i“ separat, um zu prüfen, ob das Problem aus der Vorverarbeitungsphase stammt.