Documentation

Begin met het eerste commando

Deze pagina behandelt installatie, de keuze van de doel-GCC, veelgebruikte commandoregels, PCH, diagnostiek en probleemoplossing. De volledige implementatie en testmatrix staan in de GitHub-repository.

Installatie

Download het Windows x64-archief en pak het uit in een map naar keuze. CrucibleCpp is een statisch gelinkt programma in één bestand, dus u hoeft geen runtime te installeren.

cruciblecpp-preprocessor.exe --version # cruciblecpp-preprocessor 3.0.1
Huidig productiedoel: Windows x64 + MinGW-w64 UCRT64. Andere platformen, ABI's en GCC-versies worden niet gegarandeerd ondersteund.

Snel starten

Controleer eerst of PATH de beoogde g++.exe bevat. Vervang daarna gewoon uw bestaande g++ -E:

# Preprocessen .\cruciblecpp-preprocessor.exe -P -std=c++20 src\main.cpp -o build\main.i # Met dezelfde GCC compileren g++ -std=c++20 build\main.i -o build\main.exe

Als de doel-GCC niet in PATH staat, gebruik --gcc om die expliciet op te geven:

.\cruciblecpp-preprocessor.exe ` --gcc "D:\GCC1413\gcc14\bin\g++.exe" ` -P -std=c++20 src\main.cpp -o build\main.i

GCC kiezen

CrucibleCpp gebruikt de voorgedefinieerde macro's van de doel-GCC, __has_* data en include-zoekpaden. Gebruik geen GCC15-profiel om GCC14-headers te preprocessen.

MethodeGedrag
--gcc-version=13|14|15Zoek in PATH naar de hoogst ondersteunde compiler die bij de hoofdversie past
--gcc <g++.exe>Gebruik de opgegeven compiler rechtstreeks en lees de versie en include-paden ervan
Niet opgegevenPATH scannen en standaard de hoogst ondersteunde versie kiezen (15 → 14 → 13)
Automatische detectie scant alleen PATH. Staat de compiler elders, voeg die map dan toe aan PATH of gebruik --gcc, en vertrouw niet op een vaste schijfletter.

Ondersteunde standaardprofielen:

-std=c++11 C++11 profile -std=c++14 C++14 profile -std=c++17 C++17 profile -std=c++20 C++20 profile

Veelgebruikte commandoregels

ParameterFunctie
-PGeen line markers uitvoeren
-o <file>Uitvoerbestand
-I <dir>Include-map toevoegen
-isystem <dir>Systeemheader-mappen
-D / -UMacro's definiëren / ongedefinieerd maken
-include <file>Geforceerd opnemen
-MD -MF -MTMake/CMake-afhankelijkheidsbestanden genereren
-finput-charset / -fexec-charsetInvoer- / uitvoeringstekenset
--embed-dir <dir>#embed zoekmappen
--analysis-json <file>Include-graaf, macro trace en PCH-registraties uitvoeren

PCH

GCC's g++ -E gebruikt geen .gch; PCH wordt alleen bij het echte compileren gebruikt. Standaard leest CrucibleCpp de headerbronnen en kan het extern gegenereerde PCH's optioneel valideren, registreren en cachen.

# Waarschuwing geven wanneer een .gch wordt gevonden --pch=warn # Direct een fout melden wanneer een .gch wordt gevonden --pch=error # Genegeerde PCH's vastleggen in de analysis JSON --pch=report

PCH-cache inschakelen:

.\cruciblecpp-preprocessor.exe ` --pch-cache .cache\pch ` --pch-cache-stats .cache\pch\stats.json ` -P src\main.cpp -o build\main.i

Het cache-manifest registreert het compilerpad, de versie, de compilerhash en de optiehash. PCH's van GCC13/14/15 veroorzaken onderling geen valse cachetreffers.

Diagnostiek

Standaard worden GCC-stijl bronregels en caret weergegeven. U kunt dit uitschakelen of aanpassen:

-fdiagnostics-color=auto|always|never -fno-diagnostics-show-caret -fno-diagnostics-show-option -Werror -Wno-error=name --max-errors 20

Ondersteunt #pragma GCC diagnostic push/pop/ignored/warning/error en #pragma GCC system_header. Headers die via -isystem zijn opgenomen, onderdrukken standaard gewone waarschuwingen, en -Wsystem-headers kan ze weer tonen.

Probleemoplossing

Standaardbibliotheekheaders niet gevonden

De doelcompiler staat niet in PATH. Gebruik --gcc om die op te geven, of voeg de map bin toe aan PATH. U kunt ook -isystem gebruiken om die expliciet door te geven.

Verkeerde GCC-versie gekozen

Gebruik --gcc-version=13|14|15 om de hoofdversie vast te zetten, of gebruik --gcc voor een specifieke g++.exe. Meng een doelprofiel niet met headers uit een andere versie.

PCH-cache meldt corrupt

De PCH komt niet overeen met de huidige compiler/opties, of het bestand is beschadigd. Verwijder het bijbehorende cache-item en genereer het opnieuw; u kunt de PCH-cache ook helemaal uitschakelen, zodat de headerbronnen worden gelezen.

GCC kan de uitvoer niet compileren

Controleer eerst of preprocessing en compilatie dezelfde GCC-versie en -std gebruiken. Compileer daarna de ‘.i’ van CrucibleCpp apart, om te controleren of het probleem uit de preprocessingsfase komt.

CrucibleCpp is een preprocessor, geen compiler. Het verzorgt geen codegeneratie, optimalisatie, linking of het parsen van het interne binaire PCH-formaat van GCC.