Справочник

Пресет

Набор настроек CMake под одним именем, записанный в файл CMakePresets.json в папке проекта. Вместо длинной команды с флагами пишут имя: cmake --preset vs2026.

Без пресетов настройки живут в команде: генератор, архитектура, папка сборки — всё это флаги, которые нужно набирать заново при каждой настройке проекта: на новом компьютере, в новой папке сборки или после удаления старой. Ошибиться в этих флагах нельзя. Пресет записывает флаги один раз в файл CMakePresets.json, который лежит рядом с CMakeLists.txt и хранится вместе с кодом.

Главное, что дают пресеты: консоль, Visual Studio и любой, кто скачает проект, собирают его одинаково — одним генератором и в одну папку.

В файле CMakePresets.json два раздела, и в каждом лежит список пресетов своего вида. Название раздела — слово на английском, а после названия идёт список пресетов в квадратных скобках. Наведи на название вида в таблице, чтобы увидеть его кусок файла:

Вид Где в файле Что задаёт Команда

Вид	Где в файле	Что задаёт	Команда
пресет настройки	`configurePresets`	генератор, архитектуру, папку сборки	`cmake --preset vs2026`
пресет сборки	`buildPresets`	какой пресет настройки собирать и вариант: Debug или Release	`cmake --build --preset debug`

пресет настройки

configurePresets

генератор, архитектуру, папку сборки

cmake --preset vs2026

пресет сборки

buildPresets

какой пресет настройки собирать и вариант: Debug или Release

cmake --build --preset debug

Зачем у пресета два имени

У каждого пресета два имени: name — для команд, displayName — для людей. Команда cmake --list-presets показывает оба, а Visual Studio показывает displayName пресетов сборки в своём списке конфигураций.