Εγκατάσταση
Κατεβάστε το αρχείο ZIP για Windows x64 και αποσυμπιέστε το σε οποιονδήποτε κατάλογο. Το CrucibleCpp είναι ένα στατικά συνδεδεμένο πρόγραμμα μεμονωμένου αρχείου και δεν απαιτεί εγκατάσταση runtime.
Γρήγορη εκκίνηση
Βεβαιωθείτε πρώτα ότι το PATH περιέχει το g++.exe. Στη συνέχεια, αντικαταστήστε απευθείας το g++ -E:
Αν δεν έχετε προσθέσει τον GCC-στόχο στο PATH, χρησιμοποιήστε --gcc για να το καθορίσετε ρητά:
Επιλογή GCC
Το CrucibleCpp χρησιμοποιεί τις προκαθορισμένες μακροεντολές του GCC-στόχου, τα __has_* δεδομένα και τις διαδρομές αναζήτησης include. Μην χρησιμοποιείτε το profile του GCC15 για να προεπεξεργαστείτε headers του GCC14.
| Τρόπος | Συμπεριφορά |
|---|---|
--gcc-version=13|14|15 | Αναζήτηση στο PATH της υψηλότερης υποστηριζόμενης έκδοσης που ταιριάζει με την κύρια έκδοση |
--gcc <g++.exe> | Χρήση απευθείας του καθορισμένου μεταγλωττιστή και ανάγνωση της έκδοσης και των διαδρομών include |
| Χωρίς προσδιορισμό | Σάρωση του PATH, προεπιλογή της υψηλότερης υποστηριζόμενης έκδοσης (15 → 14 → 13) |
--gcc, χωρίς να βασίζεστε σε σταθερό γράμμα δίσκου.Υποστηριζόμενα standard profiles:
Συχνές γραμμές εντολών
| Παράμετρος | Λειτουργία |
|---|---|
-P | Δεν παράγει line markers |
-o <file> | Αρχείο εξόδου |
-I <dir> | Προσθήκη καταλόγου include |
-isystem <dir> | Κατάλογος headers συστήματος |
-D / -U | Ορισμός / ακύρωση μακροεντολών |
-include <file> | Αναγκαστική συμπερίληψη |
-MD -MF -MT | Δημιουργία αρχείων εξαρτήσεων Make/CMake |
-finput-charset / -fexec-charset | Σύνολα χαρακτήρων εισόδου / εκτέλεσης |
--embed-dir <dir> | #embed κατάλογος αναζήτησης |
--analysis-json <file> | Έξοδος σε γράφο include, macro trace και εγγραφές PCH |
PCH
Το g++ -E του GCC δεν χρησιμοποιεί .gch· τα PCH χρησιμοποιούνται μόνο κατά την πραγματική μεταγλώττιση. Το CrucibleCpp διαβάζει από προεπιλογή τον πηγαίο κώδικα των headers και προαιρετικά επικυρώνει, καταγράφει και αποθηκεύει σε cache εξωτερικά παραγόμενα PCH.
Ενεργοποίηση cache PCH:
Το manifest της cache καταγράφει τη διαδρομή του μεταγλωττιστή, την έκδοση, το hash του μεταγλωττιστή και το hash των επιλογών. Τα PCH των GCC13/14/15 δεν συγκρούονται μεταξύ τους.
Διαγνωστικά
Από προεπιλογή παράγονται γραμμές πηγαίου κώδικα και caret σε στυλ GCC. Μπορούν να απενεργοποιηθούν ή να ρυθμιστούν:
Υποστηρίζει #pragma GCC diagnostic push/pop/ignored/warning/error και #pragma GCC system_header. Τα headers που προέρχονται από -isystem καταστέλλουν εξ ορισμού τις συνήθεις προειδοποιήσεις, -Wsystem-headers τις εμφανίζει ξανά.
Αντιμετώπιση προβλημάτων
Δεν βρίσκονται headers της standard library
Ο μεταγλωττιστής-στόχος δεν βρίσκεται στο PATH. Χρησιμοποιήστε --gcc για να τον καθορίσετε, ή προσθέστε τον κατάλογο bin στο PATH. Μπορείτε επίσης να χρησιμοποιήσετε -isystem για να το περάσετε ρητά.
Επιλέχθηκε λάθος έκδοση GCC
Χρησιμοποιήστε --gcc-version=13|14|15 για να καθορίσετε την κύρια έκδοση, ή --gcc για να δείξετε ένα συγκεκριμένο g++.exe. Μην αναμειγνύετε το target profile με headers άλλης έκδοσης.
Η cache PCH αναφέρει corrupt
Το PCH δεν ταιριάζει με τον τρέχοντα μεταγλωττιστή/τις επιλογές ή το αρχείο είναι κατεστραμμένο. Διαγράψτε την αντίστοιχη καταχώριση cache και δημιουργήστε το ξανά· μπορείτε επίσης να απενεργοποιήσετε την cache PCH ώστε να διαβάζει τον πηγαίο κώδικα των headers.
Η έξοδος δεν μεταγλωττίζεται από το GCC
Βεβαιωθείτε πρώτα ότι η προεπεξεργασία και η μεταγλώττιση χρησιμοποιούν την ίδια έκδοση GCC και την ίδια επιλογή -std. Στη συνέχεια, μεταγλωττίστε χωριστά το «.i που παράγει το CrucibleCpp» για να επιβεβαιώσετε αν το πρόβλημα προέρχεται από το στάδιο προεπεξεργασίας.