github学习cmake项目｜从零掌握 CMake 构建系统

CMake（Cross-Platform Make）并非编译器，而是一个构建系统生成器（Build System Generator）。

它的工作流程是：
CMakeLists.txt（配置脚本） → CMake → 生成 Makefile / Ninja / Visual Studio 工程 → 编译器/链接器 → 可执行文件

通俗讲：CMake 是“指挥官”，负责组织源码、依赖、编译选项；真正的“干活”是 GCC、Clang、MSVC 等编译器完成的。

• ✅ 跨平台：一套脚本支持 Windows/macOS/Linux，无需维护多套构建脚本
• ✅ 依赖管理：通过 find_package() 自动定位第三方库（如 OpenCV、Boost）
• ✅ 模块化：支持子目录分层构建（如 src/, tests/, examples/）
• ✅ 生态整合：与 CI/CD（GitHub Actions）、测试（CTest）、打包（CPack）深度集成

以 github学习cmake项目 中的 CMake 官方 Complex 测试项目 为例，其结构清晰展示了多目录、多库、多可执行文件的协同构建逻辑。

每个 CMake 项目至少包含一个 CMakeLists.txt 文件，其核心三要素：

# 1. 指定 CMake 最低版本
cmake_minimum_required(VERSION 3.16)
# 定义项目信息
project(MyApp VERSION 1.0.0
        DESCRIPTION "A simple CMake project"
        LANGUAGES CXX)
# 添加源码与可执行目标
add_executable(myapp src/main.cpp src/utils.cpp)

运行 cmake . && cmake --build . 即可生成并构建项目。

通过 CMAKE_SYSTEM_NAME 区分平台：

if(CMAKE_SYSTEM_NAME STREQUAL "Windows")
    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} /W4 /permissive-")
elseif(CMAKE_SYSTEM_NAME STREQUAL "Linux")
    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -Wextra -std=c++17")
elseif(CMAKE_SYSTEM_NAME STREQUAL "Darwin")
    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -Wextra -std=c++17 -stdlib=libc++")
endif()

更推荐使用 target_compile_options() 作用于具体目标，避免污染全局。

通过选项变量控制构建类型：

option(BUILD_SHARED_LIBS "Build shared libraries" ON)
add_library(mylib src/lib.cpp)
# 如果需要强制静态库
set_target_properties(mylib PROPERTIES
    POSITION_INDEPENDENT_CODE ON)

注意：Windows 下静态库需链接 MSVCRTD，建议统一用 CMAKE_MSVC_RUNTIME_LIBRARY（CMake ≥3.15）。

使用 ExternalProject_Add 管理外部依赖，避免重复下载：

include(ExternalProject)
ExternalProject_Add(fmtlib
    GIT_REPOSITORY https://github.com/fmtlib/fmt.git
    GIT_TAG 9.1.0
    UPDATE_DISCONNECTED 1
    CMAKE_ARGS -DFMT_TEST=OFF -DFMT_DOC=OFF
    INSTALL_COMMAND ""  # 不安装，直接用构建产物
    BUILD_BYPRODUCTS ${CMAKE_BINARY_DIR}/fmtlib/lib/libfmt.a)
# 引用构建产物
add_library(fmt::fmt STATIC IMPORTED)
set_target_properties(fmt::fmt PROPERTIES
    IMPORTED_LOCATION ${CMAKE_BINARY_DIR}/fmtlib/lib/libfmt.a
    INTERFACE_INCLUDE_DIRECTORIES ${CMAKE_BINARY_DIR}/fmtlib/include)

此方案在 github学习cmake项目 中广泛用于管理 GitHub 依赖，比 FetchContent 更稳定（支持离线构建）。