Сборка проектов LinuxWindowsmacOS

CMake: No CMAKE_CXX_COMPILER could be found

  • Обновлено
  • Чтение ≈ 2 минуты

Краткий ответ

Компилятор C++ не установлен или не найден. Установите build-essential (g++) или Build Tools и очистите кэш CMake.

В этой статье
  1. Что означает ошибка
  2. Причины и признаки
  3. Пошаговое решение
  4. Если проблема осталась

#Что означает ошибка

Сообщение
No CMAKE_CXX_COMPILER

Компилятор C++ не установлен или не найден. Установите build-essential (g++) или Build Tools и очистите кэш CMake.

#Причины и признаки

Возможная причинаКак узнатьЧто делать
Нет компилятораКоманды c++ или cl не найдены.Установите компилятор соответствующей ОС.
Не в PATHКомпилятор установлен, но терминал его не находит.Откройте подходящее окружение и проверьте PATH.
Кэш CMakeВ кэше указан удалённый компилятор.Сконфигурируйте новый каталог сборки.
Неверный генераторГенератор CMake не соответствует инструментам.Выберите установленный генератор, сверив cmake -G.

#Пошаговое решение

  1. Выясните, какой компилятор нуженОткройте терминал в корне проекта (в VS Code: «Терминал → Создать терминал»). Запустите cmake --version и c++ --version в Linux/macOS либо cl в «Developer Command Prompt for VS» на Windows. Если команда не найдена, компилятор не установлен или не добавлен в окружение; запишите выбранный генератор и имя отсутствующего компилятора из сообщения CMake.
  2. Установите инструменты для своей ОСНа Ubuntu/Debian после согласования с администратором выполните sudo apt update и sudo apt install build-essential cmake; в macOS используйте xcode-select --install; на Windows откройте Visual Studio Installer → «Изменить» → рабочая нагрузка «Разработка классических приложений на C++» с компилятором MSVC. Эти варианты относятся к разным ОС, выполняйте только свой.
  3. Создайте новый каталог сборкиВернитесь в корень проекта с CMakeLists.txt. Для Unix-подобной системы выполните cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug; на Windows с MSVC — из Developer Command Prompt запустите cmake -S . -B build -G "Visual Studio 17 2022" только если установлен именно этот генератор. При старом неверном кэше используйте другое имя каталога, не удаляя исходники.
  4. Проверьте найденный компиляторВ выводе конфигурации должны появиться строки The CXX compiler identification и Configuring done, затем выполните cmake --build build. Если ошибка не ушла, в build/CMakeCache.txt проверьте CMAKE_CXX_COMPILER и пришлите CMakeError.log/CMakeConfigureLog.yaml из дерева сборки, если они созданы.

#Если проблема осталась

Если «CMake: No CMAKE_CXX_COMPILER could be found» повторяется, сохраните время, состояние подключения и точный текст ошибки. Не меняйте сразу несколько настроек — иначе станет трудно понять, какое действие повлияло на результат.

Так эту ошибку тоже называют

Источники и обновления

Последнее обновление статьи: 2 ноября 2026. Версии программ и интерфейсы меняются — если шаги не совпадают с вашей версией, сверяйтесь с документацией производителя.