В чем разница между Debug и Release сборками в CMake и как их правильно настраивать?

Что происходит по умолчанию и зачем нужен CMAKE_BUILD_TYPE?

Если не указать CMAKE_BUILD_TYPE, CMake не устанавливает никаких специальных флагов компиляции. Это означает, что сборка будет с настройками по умолчанию для вашего компилятора (обычно без оптимизаций и без отладочной информации). Для простых проектов это может работать, но для серьезной разработки нужно явно задавать конфигурацию.

Правильная команда для сборки в Debug:

cmake -DCMAKE_BUILD_TYPE=Debug ..
cmake --build .

Для Release:

cmake -DCMAKE_BUILD_TYPE=Release ..
cmake --build .

Встроенные переменные CMake для флагов компиляции

CMake предоставляет переменные для каждого типа сборки. Вот основные:

• CMAKE_CXX_FLAGS_DEBUG — флаги для C++ в Debug режиме (обычно -g -O0)
• CMAKE_CXX_FLAGS_RELEASE — флаги для C++ в Release режиме (обычно -O3 -DNDEBUG)
• CMAKE_C_FLAGS_DEBUG и CMAKE_C_FLAGS_RELEASE — то же для C
• CMAKE_EXE_LINKER_FLAGS_DEBUG и CMAKE_EXE_LINKER_FLAGS_RELEASE — для линковки

Пример настройки в CMakeLists.txt:

cmake_minimum_required(VERSION 3.10)
project(MyProject)

# Настройка Debug: отладочная информация, без оптимизаций
set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} -g -O0")
# Настройка Release: полная оптимизация, отключаем assert-ы
set(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} -O3 -DNDEBUG")

# Если нужно статически линковать стандартную библиотеку в Release
if(CMAKE_BUILD_TYPE STREQUAL "Release")
    set(CMAKE_EXE_LINKER_FLAGS_RELEASE "${CMAKE_EXE_LINKER_FLAGS_RELEASE} -static-libstdc++ -static-libgcc")
endif()

add_executable(myapp main.cpp)

Как работают assert-ы в Debug и Release

Макрос assert из <cassert> ведет себя так:

• Debug: assert-ы активны, так как макрос NDEBUG не определен
• Release: assert-ы отключаются, потому что -DNDEBUG добавляется автоматически в CMAKE_CXX_FLAGS_RELEASE

Вот пример кода, который это демонстрирует:

#include <iostream>
#include <cassert>

int divide(int a, int b) {
    assert(b != 0 && "Division by zero!");
    return a / b;
}

int main() {
    std::cout << "Build type: ";
    #ifdef NDEBUG
        std::cout << "Release (asserts disabled)" << std::endl;
    #else
        std::cout << "Debug (asserts enabled)" << std::endl;
    #endif

    // В Debug вызовет abort, в Release — неопределенное поведение
    std::cout << divide(10, 0) << std::endl;
    return 0;
}

Современный подход: target-based свойства

Начиная с CMake 3.0, лучше использовать свойства целей вместо глобальных переменных. Это более гибко и безопасно:

cmake_minimum_required(VERSION 3.10)
project(MyProject)

add_executable(myapp main.cpp)

# Debug: отладочная информация
target_compile_options(myapp PRIVATE
    $<$<CONFIG:Debug>:-g -O0>
)

# Release: оптимизация и отключение assert-ов
target_compile_options(myapp PRIVATE
    $<$<CONFIG:Release>:-O3 -DNDEBUG>
)

# Статическая линковка в Release
target_link_options(myapp PRIVATE
    $<$<CONFIG:Release>:-static-libstdc++ -static-libgcc>
)

Генераторные выражения $<$<CONFIG:Debug>:...> применяют флаги только для указанной конфигурации.

Важное замечание для многоконфигурационных генераторов (Visual Studio, Xcode)

Если вы используете Visual Studio или Xcode, CMAKE_BUILD_TYPE игнорируется. Вместо этого конфигурация задается при сборке:

cmake -G "Visual Studio 17 2022" ..
cmake --build . --config Debug
cmake --build . --config Release

В этом случае все настройки через target_compile_options с генераторными выражениями работают корректно, а глобальные переменные CMAKE_CXX_FLAGS_DEBUG — тоже.

{
    "version": 3,
    "configurePresets": [
        {
            "name": "debug",
            "displayName": "Debug",
            "description": "Debug build with asserts",
            "cacheVariables": {
                "CMAKE_BUILD_TYPE": "Debug",
                "CMAKE_CXX_FLAGS_DEBUG": "-g -O0 -Wall -Wextra"
            }
        },
        {
            "name": "release",
            "displayName": "Release",
            "description": "Optimized build without asserts",
            "cacheVariables": {
                "CMAKE_BUILD_TYPE": "Release",
                "CMAKE_CXX_FLAGS_RELEASE": "-O3 -DNDEBUG -march=native"
            }
        }
    ],
    "buildPresets": [
        {
            "name": "debug",
            "configurePreset": "debug"
        },
        {
            "name": "release",
            "configurePreset": "release"
        }
    ]
}

# Конфигурация
cmake --preset debug
cmake --preset release

# Сборка
cmake --build --preset debug
cmake --build --preset release