Installazione
Scarica l'archivio Windows x64 e decomprimilo in una directory qualsiasi. CrucibleCpp è un programma in un unico file con linking statico: non serve installare alcun runtime.
Avvio rapido
Assicurati che nel PATH sia presente il g++.exe. Poi sostituisci direttamente il tuo g++ -E:
Se il GCC target non è nel PATH, usa --gcc per specificarlo esplicitamente:
Scelta di GCC
CrucibleCpp usa le macro predefinite del GCC target, i dati di __has_* e i percorsi di ricerca degli include. Non usare un profilo GCC 15 per preprocessare gli header di GCC 14.
| Modalità | Comportamento |
|---|---|
--gcc-version=13|14|15 | Cerca nel PATH il compilatore supportato più recente con la stessa versione principale |
--gcc <g++.exe> | Usa direttamente il compilatore indicato e ne legge la versione e i percorsi di include |
| Non specificato | Analizza il PATH e sceglie per impostazione predefinita la versione supportata più alta (15 → 14 → 13) |
--gcc, e non affidarti a una lettera di unità fissa.Profili standard supportati:
Righe di comando comuni
| Parametro | Funzione |
|---|---|
-P | Non emette line markers |
-o <file> | File di output |
-I <dir> | Aggiunge una directory di include |
-isystem <dir> | Directory degli header di sistema |
-D / -U | Definisce / annulla macro |
-include <file> | Inclusione forzata |
-MD -MF -MT | Genera file di dipendenze Make/CMake |
-finput-charset / -fexec-charset | Set di caratteri di input / esecuzione |
--embed-dir <dir> | #embed directory di ricerca |
--analysis-json <file> | Genera grafo degli include, macro trace e record PCH |
PCH
La modalità g++ -E di GCC non usa .gch; il PCH viene usato solo durante la compilazione reale. Per impostazione predefinita CrucibleCpp legge i sorgenti degli header e può, facoltativamente, convalidare, registrare e mettere in cache i PCH generati esternamente.
Abilita la cache PCH:
Il manifest della cache registra il percorso e la versione del compilatore, l'hash del compilatore e quello delle opzioni. I PCH di GCC13/14/15 non producono falsi riscontri tra loro.
Diagnostica
Per impostazione predefinita emette righe di sorgente e caret in stile GCC. Puoi disattivarli o regolarli:
Supporta #pragma GCC diagnostic push/pop/ignored/warning/error e #pragma GCC system_header. Gli header provenienti da -isystem sopprimono per impostazione predefinita i warning ordinari, mentre -Wsystem-headers può mostrarli di nuovo.
Risoluzione dei problemi
Header della libreria standard non trovati
Il compilatore target non è nel PATH. Usa --gcc per specificarlo, oppure aggiungi la directory bin al PATH. Puoi anche usare -isystem per passarla esplicitamente.
Versione di GCC scelta errata
Usa --gcc-version=13|14|15 per fissare la versione principale, oppure --gcc per puntare a uno specifico g++.exe. Non mescolare un profilo target con gli header di un'altra versione.
La cache PCH segnala “corrupt”
Il PCH non corrisponde al compilatore o alle opzioni correnti, oppure il file è danneggiato. Elimina la voce di cache corrispondente e rigeneralo; in alternativa puoi disattivare del tutto la cache PCH e lasciare che legga i sorgenti degli header.
Output non compilabile con GCC
Assicurati innanzitutto che preprocessing e compilazione usino la stessa versione di GCC e la stessa opzione -std. Poi compila separatamente il “.i generato da CrucibleCpp” per capire se il problema nasce dalla fase di preprocessing.