Установка
Скачайте архив для 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 не путаются между собой.
Диагностика
По умолчанию выводятся строки исходника и caret в стиле GCC. Это можно отключить или настроить:
Поддерживается #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», чтобы проверить, не связана ли проблема с этапом препроцессирования.