Instalacja
Pobierz archiwum Windows x64 i rozpakuj je do dowolnego katalogu. CrucibleCpp to statycznie linkowany program jednoplikowy, więc nie trzeba instalować środowiska uruchomieniowego.
Szybki start
Najpierw upewnij się, że w PATH znajduje się docelowy g++.exe. Następnie zastąp dotychczasowe g++ -E:
Jeśli docelowy GCC nie znajduje się w PATH, użyj --gcc i wskaż go jawnie:
Wybór GCC
CrucibleCpp korzysta z predefiniowanych makr docelowego GCC,__has_* danych i ścieżek wyszukiwania include. Nie używaj profilu GCC15 do preprocessingu nagłówków GCC14.
| Sposób | Zachowanie |
|---|---|
--gcc-version=13|14|15 | Wyszukiwanie w PATH najwyższego obsługiwanego kompilatora zgodnego z wersją główną |
--gcc <g++.exe> | Użycie wskazanego kompilatora wraz z odczytem jego wersji i ścieżek include |
| Nie podano | Skanowanie PATH z domyślnym wyborem najwyższej obsługiwanej wersji (15 → 14 → 13) |
--gcc i nie polegaj na stałej literze dysku.Obsługiwane profile standardów:
Najczęstsze polecenia
| Parametr | Działanie |
|---|---|
-P | Bez wypisywania line markers |
-o <file> | Plik wyjściowy |
-I <dir> | Dodawanie katalogu include |
-isystem <dir> | Katalogi nagłówków systemowych |
-D / -U | Definiowanie / usuwanie definicji makr |
-include <file> | Wymuszone dołączenie |
-MD -MF -MT | Generowanie plików zależności Make/CMake |
-finput-charset / -fexec-charset | Zestaw znaków wejściowy / wykonawczy |
--embed-dir <dir> | #embed — katalogi wyszukiwania |
--analysis-json <file> | Wypisywanie grafu include, macro trace i rekordów PCH |
PCH
GCC-owe g++ -E nie używa .gch; PCH jest używany tylko podczas rzeczywistej kompilacji. CrucibleCpp domyślnie czyta źródła nagłówków i opcjonalnie weryfikuje, rejestruje oraz buforuje zewnętrznie wygenerowane PCH.
Włączanie pamięci podręcznej PCH:
Manifest pamięci podręcznej zapisuje ścieżkę kompilatora, wersję, hash kompilatora i hash opcji. PCH z GCC13/14/15 nie kolidują ze sobą.
Diagnostyka
Domyślnie wypisywane są wiersze źródłowe i caret w stylu GCC. Można to wyłączyć lub dostosować:
Obsługuje #pragma GCC diagnostic push/pop/ignored/warning/error i #pragma GCC system_header. Nagłówki z -isystem domyślnie wyciszają zwykłe ostrzeżenia, a-Wsystem-headers może je ponownie wyświetlić.
Rozwiązywanie problemów
Nie znaleziono nagłówków biblioteki standardowej
Docelowego kompilatora nie ma w PATH. Użyj --gcc , aby go wskazać, albo dodaj jego katalog bin do PATH. Możesz też użyć -isystem i przekazać go jawnie.
Wybrano niewłaściwą wersję GCC
Użyj --gcc-version=13|14|15 , aby ustalić wersję główną, lub użyj --gcc , aby wskazać konkretny g++.exe. Nie mieszaj profilu docelowego z nagłówkami innej wersji.
Pamięć podręczna PCH zgłasza corrupt
PCH nie pasuje do bieżącego kompilatora/opcji lub plik jest uszkodzony. Usuń odpowiedni wpis pamięci podręcznej i wygeneruj go ponownie; możesz też całkowicie wyłączyć pamięć podręczną PCH, aby czytała źródła nagłówków.
Nie można skompilować wyniku w GCC
Najpierw upewnij się, że preprocessing i kompilacja używają tej samej wersji GCC i -std. Następnie skompiluj osobno „.i wygenerowany przez CrucibleCpp”, aby sprawdzić, czy problem pochodzi z etapu preprocessingu.