Installation
Download Windows x64-arkivet, og udpak det til en vilkårlig mappe. CrucibleCpp er et statisk linket program i én fil, og der kræves ingen runtime-installation.
Hurtig start
Kontrollér først, at målet kan findes i PATH g++.exe. Erstat derefter direkte den oprindelige g++ -E:
Hvis mål-GCC'en ikke er lagt i PATH, brug --gcc Angiv eksplicit:
Vælg GCC
CrucibleCpp bruger mål-GCC'ens indbyggede makroer,__has_* data og include-søgestier. Brug ikke GCC15's profil til at præprocessere GCC14's header-filer.
| Måde | Adfærd |
|---|---|
--gcc-version=13|14|15 | Søger i PATH efter den højest understøttede compiler med matchende hovedversion |
--gcc <g++.exe> | Brug den angivne compiler direkte, og læs dens version og include-stier |
| Hvis du ikke angiver | Scanner PATH og vælger som standard den højest understøttede version (15 → 14 → 13) |
--gcc, og undgå at stole på faste drevbogstaver.Understøttede standardprofiler:
Almindelige kommandolinjer
| Parameter | Formål |
|---|---|
-P | Udsender ikke line markers |
-o <file> | Outputfil |
-I <dir> | Tilføj include-mappe |
-isystem <dir> | Systemheader-mappe |
-D / -U | Definér / ophæv makroer |
-include <file> | Tving include |
-MD -MF -MT | Generér Make/CMake-afhængighedsfil |
-finput-charset / -fexec-charset | Input-/udførelsestegnsæt |
--embed-dir <dir> | #embed søgemappe |
--analysis-json <file> | Udsender include-graf, makro-trace og PCH-poster |
PCH
GCC's g++ -E bruger ikke .gch; PCH bruges kun ved den egentlige kompilering. CrucibleCpp læser som standard header-kildekoden og kan valgfrit validere, registrere og cache eksternt genererede PCH'er.
Aktivér PCH-cache:
Cache-manifestet registrerer compilersti, version, compiler-hash og hash for optioner. PCH'er fra GCC13/14/15 rammer ikke hinanden ved en fejl.
Diagnostik
Som standard udsendes GCC-stil kildekodelinjer og caret. Det kan slås fra eller justeres:
Understøtter #pragma GCC diagnostic push/pop/ignored/warning/error og #pragma GCC system_header. Fra -isystem header-filer undertrykker som standard almindelige advarsler,-Wsystem-headers kan vises igen.
Fejlfinding
Kan ikke finde standardbibliotekets header-filer
Målkompileren er ikke i PATH. Brug --gcc angiver, eller tilføj dens bin -mappen til PATH. Du kan også bruge -isystem sendes eksplicit.
Forkert GCC-version valgt
Med --gcc-version=13|14|15 låser hovedversionen, eller brug --gcc peger på en bestemt g++.exe. Bland ikke en targetprofil med header-filer fra en anden version.
PCH-cachen rapporterer corrupt
PCH'en matcher ikke den aktuelle compiler/optioner, eller filen er beskadiget. Slet den pågældende cachepost, og generér den igen; du kan også slå PCH-cachen fra, så header-kildekoden læses i stedet.
Outputtet kan ikke kompileres af GCC
Kontrollér først, at præprocessering og kompilering bruger samme GCC-version og -std. Kompilér derefter “den .i-fil, som CrucibleCpp genererede” separat for at afgøre, om problemet stammer fra præprocesseringen.