CMake 是高階構建配置工具,根據平台/編譯器生成 Makefile 或 VS 專案。掌握 CMakeLists.txt 編寫,即可掌控編譯、測試、安裝、打包全生命週期。
CMakeLists.txt (源碼根目錄)mkdir build && cd buildcmake .. (生成構建文件)cmake --build . / make / 打開 .sln 編譯ctest / make test 運行測試cmake --install . / make install 安裝cpack / make package 生成安裝包


cmake_minimum_required(VERSION 2.8)
project(Tutorial)
add_executable(Tutorial tutorial.cxx)
cmake .. && make → 生成 Tutorial.exe。


# MathFunctions/CMakeLists.txt
add_library(MathFunctions mysqrt.cxx)
# 根 CMakeLists.txt
include_directories("${PROJECT_SOURCE_DIR}/MathFunctions")
add_subdirectory(MathFunctions)
add_executable(Tutorial tutorial.cxx)
target_link_libraries(Tutorial MathFunctions)
構建過程:先編譯靜態庫 libMathFunctions.a,再鏈接主程序。

# 安裝目標
install(TARGETS Tutorial DESTINATION bin)
install(TARGETS MathFunctions DESTINATION lib)
install(FILES MathFunctions.h TutorialConfig.h DESTINATION include)
# 測試用例
enable_testing()
add_test(NAME TutorialRuns COMMAND Tutorial 25)
# 參數化測試宏
macro(do_test arg expected_output)
add_test(NAME TutorialComp${arg} COMMAND Tutorial ${arg})
set_tests_properties(TutorialComp${arg} PROPERTIES PASS_REGULAR_EXPRESSION ${expected_output})
endmacro()
do_test(25 "25 is 5")
do_test(-25 "-25 is 0")
make install 輸出至 CMAKE_INSTALL_PREFIX (默認 C:/Program Files/Tutorial / /usr/local):


make test / ctest 運行所有測試:

| 指令 | 用途 |
|---|---|
set(VAR value) | 定義變量 |
option(OPT "desc" ON/OFF) | 用戶可選選項 |
add_definitions(-DFOO) | 編譯器宏定義 |
include_directories(dir) | 頭文件搜索路徑 |
target_include_libraries(tgt PRIVATE/PUBLIC/INTERFACE dir) | 現代目標專用/傳遞依賴 (現代 CMake 推薦) |
find_package(Pkg REQUIRED) | 尋找第三方庫 (OpenCV, Boost, Qt...) |
add_custom_target/command | 自定義構建步驟 |
configure_file(in.out) | 模板生成配置文件 |
target 設置屬性 (target_compile_options, target_link_libraries, target_include_directories),自動傳遞依賴,避免全局汙染。PRIVATE (僅內部), PUBLIC (接口+內部), INTERFACE (僅接口)。target_link_libraries(MyTarget PUBLIC Pkg::Pkg) 導入 find_package 發現的現代目標。學習資源:官方教程、Modern CMake、cmake-examples。