Опция –check-build-dependencies заставляет pip проверить наличие требований сборки, объявленных проектом, прежде чем backend начнет создавать wheel. Недостающее видно раньше.

Проверяйте управляемую среду

Флаг особенно полезен рядом с –no-build-isolation, когда setuptools, Cython или другой backend уже должен находиться в текущем venv нужной версии.

python -m pip install --no-build-isolation --check-build-dependencies .

Читайте секцию build-system

Сопоставьте requires из pyproject.toml с фактическим окружением и constraints для build dependency, затем устраните конфликт до запуска долгой native compilation на runner и расходования лимита машинного времени.

Все равно собирайте артефакт

Наличие инструментов не гарантирует рабочий compiler, headers или системную библиотеку, поэтому итоговый wheel надо построить и установить в чистый venv.

Сохраняйте журнал проверки вместе с образом сборки, чтобы поздняя ошибка backend не отрывалась от конкретного набора build requirements.

Изоляцию объясняет build isolation pip. Версии фиксируют build constraints.