Asennus
Lataa Windows x64 -paketti ja pura se mihin tahansa hakemistoon. CrucibleCpp on staattisesti linkitetty yhden tiedoston ohjelma, joten ajonaikaista ei tarvitse asentaa.
Pika-aloitus
Varmista ensin, että PATHista löytyy g++.exe. Korvaa sitten suoraan vanha g++ -E:
Jos kohde-GCC ei ole PATHissa, määritä se valitsimella --gcc eksplisiittisesti:
GCC:n valinta
CrucibleCpp käyttää kohde-GCC:n esimääriteltyjä makroja, __has_* tietoja ja include-hakupolkuja. Älä käytä GCC 15:n profiilia GCC 14:n otsikkotiedostojen esikäsittelyyn.
| Tapa | Toiminta |
|---|---|
--gcc-version=13|14|15 | Etsii PATHista pääversiota vastaavan uusimman tuetun kääntäjän |
--gcc <g++.exe> | Käyttää annettua kääntäjää suoraan ja lukee sen version ja include-polut |
| Ei määritetty | Skannaa PATHin ja valitsee oletuksena uusimman tuetun version (15 → 14 → 13) |
--gcc, äläkä luota kiinteään asemakirjaimeen.Tuetut standardiprofiilit:
Yleisimmät komentorivit
| Parametri | Tarkoitus |
|---|---|
-P | Ei tulosta line-markereita |
-o <file> | Tulostiedosto |
-I <dir> | Lisää include-hakemisto |
-isystem <dir> | Järjestelmäotsikkotiedostojen hakemisto |
-D / -U | Määritä / poista makro |
-include <file> | Pakotettu include |
-MD -MF -MT | Luo Make/CMake-riippuvuustiedostot |
-finput-charset / -fexec-charset | Syöte- / suoritusmerkistö |
--embed-dir <dir> | #embed hakuhakemistot |
--analysis-json <file> | Tulostaa include-kaavion, macro tracen ja PCH-merkinnät |
PCH
GCC:n g++ -E ei käytä .gch; PCH:ta käytetään vain varsinaisessa käännöksessä. CrucibleCpp lukee oletuksena otsikkotiedostojen lähdekoodin ja voi halutessaan validoida, rekisteröidä ja tallentaa välimuistiin ulkoisesti luotuja PCH:ita.
Ota PCH-välimuisti käyttöön:
Välimuistin manifesti tallentaa kääntäjän polun, version, kääntäjän hashin ja valitsimien hashin. GCC 13/14/15:n PCH:t eivät osu vahingossa toistensa kohdalle.
Diagnostiikka
Oletuksena tulostetaan GCC-tyyliset lähdekoodirivit ja caret. Voit poistaa ne käytöstä tai säätää niitä:
Tukee #pragma GCC diagnostic push/pop/ignored/warning/error ja #pragma GCC system_header. Valitsimella -isystem tuodut otsikkotiedostot vaimentavat oletuksena tavalliset varoitukset, ja -Wsystem-headers voi näyttää ne uudelleen.
Vianmääritys
Standardikirjaston otsikkotiedostoja ei löydy
Kohdekääntäjä ei ole PATHissa. Määritä se valitsimella --gcc tai lisää sen bin hakemisto PATHiin. Voit myös käyttää -isystem ja välittää sen eksplisiittisesti.
Väärä GCC-versio valittu
Kiinnitä pääversio valitsimella --gcc-version=13|14|15 tai osoita valitsimella --gcc suoraan tiedostoon g++.exe. Älä sekoita kohdeprofiilia toisen version otsikkotiedostoihin.
PCH-välimuisti ilmoittaa virheestä “corrupt”
PCH ei vastaa nykyistä kääntäjää tai valitsimia, tai tiedosto on vioittunut. Poista vastaava välimuistimerkintä ja luo se uudelleen; voit myös kytkeä PCH-välimuistin kokonaan pois, jolloin se lukee otsikkotiedostojen lähdekoodin.
Tulostetta ei voi kääntää GCC:llä
Varmista ensin, että esikäsittely ja käännös käyttävät samaa GCC-versiota ja samaa -std. Käännä sitten “CrucibleCpp:n tuottama .i” erikseen ja varmista, johtuuko ongelma esikäsittelyvaiheesta.