Installation
Ladda ner Windows x64-arkivet och packa upp det i valfri katalog. CrucibleCpp är ett statiskt länkat program i en enda fil, så ingen runtime behöver installeras.
Snabbstart
Börja med att kontrollera att PATH innehåller rätt g++.exe. Ersätt sedan bara din befintliga g++ -E:
Om mål-GCC:n inte finns i PATH, använd --gcc för att ange den explicit:
Välj GCC
CrucibleCpp använder mål-GCC:ns fördefinierade makron,__has_* data och include-sökvägar. Använd inte en GCC 15-profil för att förbehandla GCC 14-headerfiler.
| Metod | Beteende |
|---|---|
--gcc-version=13|14|15 | Hitta den högsta version som stöds i PATH som matchar huvudversionen |
--gcc <g++.exe> | Använd den angivna kompilatorn direkt och läs dess version och include-sökvägar |
| Ej angivet | Skanna PATH och välj den högsta version som stöds som standard (15 → 14 → 13) |
--gcc, och förlita dig inte på en fast enhetsbeteckning.Standardprofiler som stöds:
Vanliga kommandorader
| Parameter | Syfte |
|---|---|
-P | Skriv inte ut line markers |
-o <file> | Utdatafil |
-I <dir> | Lägg till include-katalog |
-isystem <dir> | Kataloger för systemheaderfiler |
-D / -U | Definiera / avdefiniera makron |
-include <file> | Tvinga inkludering |
-MD -MF -MT | Generera beroendefiler för Make/CMake |
-finput-charset / -fexec-charset | Teckenuppsättning för indata / exekvering |
--embed-dir <dir> | #embed sökkataloger |
--analysis-json <file> | Skriv ut include-graf, makrospår och PCH-poster |
PCH
GCC:s g++ -E använder inte .gch; PCH används bara vid verklig kompilering. CrucibleCpp läser headerfilernas källkod som standard och kan valfritt validera, registrera och cacha externt genererade PCH:er.
Aktivera PCH-cache:
Cache-manifestet registrerar kompilatorns sökväg, version, kompilatorhash och options-hash. PCH:er från GCC 13/14/15 kolliderar inte med varandra.
Diagnostik
Som standard skrivs GCC-lika källkodsrader och caret ut. Du kan stänga av eller justera detta:
Stöder #pragma GCC diagnostic push/pop/ignored/warning/error och #pragma GCC system_header. Headerfiler som inkluderas via -isystem undertrycker vanliga varningar som standard, och-Wsystem-headers kan visa dem igen.
Felsökning
Standardbibliotekets headerfiler hittades inte
Målkompilatorn finns inte i PATH. Använd --gcc eller lägg till sökvägen till bin i PATH. Du kan också använda -isystem för att skicka in den explicit.
Fel GCC-version har valts
Använd --gcc-version=13|14|15 för att låsa huvudversionen, eller använd --gcc för att peka ut en specifik g++.exe. Blanda inte en målprofil med headerfiler från en annan version.
PCH-cachen rapporterar corrupt
PCH:en matchar inte den aktuella kompilatorn/alternativen, eller så är filen skadad. Ta bort motsvarande cachepost och generera om den; du kan också stänga av PCH-cachen helt och låta den läsa headerfilernas källkod.
GCC kan inte kompilera utdata
Kontrollera först att förbehandlingen och kompileringen använder samma GCC-version och -std. Kompilera sedan “.i” som CrucibleCpp genererade separat för att kontrollera om problemet kommer från förbehandlingsfasen.