Встановлення
Завантажте архів для Windows x64 і розпакуйте його в будь-який каталог. CrucibleCpp — статично скомпонована однофайлова програма, середовище виконання встановлювати не потрібно.
Швидкий старт
Спочатку переконайтеся, що в PATH є цільовий g++.exe. Потім просто замініть старий g++ -E:
Якщо цільовий GCC не додано до PATH, використайте --gcc для явного зазначення:
Вибір GCC
CrucibleCpp використовує попередньо визначені макроси цільового GCC, __has_* дані та шляхи пошуку include. Не використовуйте профіль GCC15 для препроцесування заголовків GCC14.
| Спосіб | Поведінка |
|---|---|
--gcc-version=13|14|15 | Знайти в PATH найвищий підтримуваний компілятор відповідної мажорної версії |
--gcc <g++.exe> | Використовувати вказаний компілятор, зчитуючи його версію та шляхи include |
| Не вказано | Сканувати PATH і за замовчуванням вибирати найвищу підтримувану версію (15 → 14 → 13) |
--gcc, не покладайтеся на фіксовану букву диска.Підтримувані стандартні профілі:
Основні команди
| Параметр | Призначення |
|---|---|
-P | Не виводити line markers |
-o <file> | Вихідний файл |
-I <dir> | Додати каталог include |
-isystem <dir> | Каталог системних заголовків |
-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
GCC-компілятор g++ -E не використовує .gch; PCH використовується лише під час справжньої компіляції. CrucibleCpp за замовчуванням читає вихідні тексти заголовків і за бажанням перевіряє, реєструє та кешує зовнішньо створені PCH.
Увімкнення кешу PCH:
Маніфест кешу записує шлях до компілятора, версію, хеш компілятора й хеш опцій. PCH від GCC13/14/15 не плутаються між собою.
Діагностика
За замовчуванням виводяться рядки вихідного коду в стилі GCC і caret. Це можна вимкнути або налаштувати:
Підтримує #pragma GCC diagnostic push/pop/ignored/warning/error і #pragma GCC system_header. Заголовки з -isystem за замовчуванням придушують звичайні попередження, а -Wsystem-headers дозволяє знову їх показати.
Усунення неполадок
Не знайдено заголовків стандартної бібліотеки
Цільовий компілятор відсутній у PATH. Укажіть його за допомогою --gcc або додайте bin до PATH. Також можна використати -isystem для явної передачі.
Вибрано неправильну версію GCC
Використовуйте --gcc-version=13|14|15 для фіксації мажорної версії або --gcc для вказівки конкретного g++.exe. Не змішуйте цільовий профіль із заголовками іншої версії.
Кеш PCH повідомляє про corrupt
PCH не відповідає поточному компілятору/опціям або файл пошкоджено. Видаліть відповідний запис кешу й створіть PCH заново; також можна повністю вимкнути кеш PCH, щоб він читав вихідні тексти заголовків.
Вивід не компілюється GCC
Спочатку переконайтеся, що препроцесування й компіляція використовують ту саму версію GCC і -std. Потім окремо скомпілюйте .i, створений CrucibleCpp, щоб перевірити, чи проблема походить з етапу препроцесування.