当前位置：首页 > news >正文

【CMake】CMake 基础笔记

news 2026/6/28 23:52:23

CMakeLists.txt 文件

CMakeLists.txt 是 CMake 的配置文件，用于定义项目的构建规则、依赖关系、编译选项等。每个 CMake 项目通常有一个或多个 CMakeLists.txt 文件。

文件结构和基本语法

1.指定 CMake 最低版本

cmake_minimum_required(VERSION 3.10)

2.定义项目

project(MyProject CXX) # 项目名和语言

3.创建可执行文件

add_executable(MyExecutable main.cpp other_file.cpp)

4.创建库

# 静态库 add_library(MyLibrary STATIC library.cpp) # 动态库 add_library(MySharedLibrary SHARED library.cpp)

5.链接库

target_link_libraries(MyExecutable MyLibrary)

6.添加包含目录

include_directories(${PROJECT_SOURCE_DIR}/include)

7.设置变量

set(CMAKE_CXX_STANDARD 11) set(MY_VAR "Hello World")

8.设置目标属性

target_include_directories(MyExecutable PRIVATE ${PROJECT_SOURCE_DIR}/include )

9.安装规则

install(TARGETS MyExecutable RUNTIME DESTINATION bin )

10.条件语句

if(CMAKE_BUILD_TYPE STREQUAL "Debug") message("Debug build") else() message("Release build") endif()

11.自定义命令

add_custom_command( TARGET MyExecutable POST_BUILD COMMAND ${CMAKE_COMMAND} -E echo "Build completed." )

完整实例

cmake_minimum_required(VERSION 3.10) project(MyProject CXX) # 添加可执行文件 add_executable(MyExecutable main.cpp) # 设置 C++ 标准 set(CMAKE_CXX_STANDARD 11)

变量系统

普通变量

set(MY_VAR "Hello World") message(STATUS "Variable is ${MY_VAR}")

缓存变量（用户可配置）

set(MY_CACHE_VAR "DefaultValue" CACHE STRING "A cache variable" )

外部库管理

查找系统库

# 基本查找 find_package(Boost REQUIRED) # 指定版本 find_package(Boost 1.70 REQUIRED) # 指定路径 find_package(OpenCV REQUIRED PATHS /path/to/opencv)

使用找到的库

target_link_libraries(MyExecutable Boost::Boost) # 传统方式（不推荐） include_directories(${Boost_INCLUDE_DIRS}) link_directories(${Boost_LIBRARY_DIRS})

Boost 库使用示例

cmake_minimum_required(VERSION 3.10) project(MyProject CXX) # 查找 Boost 库 find_package(Boost REQUIRED) # 创建可执行文件 add_executable(MyExecutable main.cpp) # 链接 Boost 库 target_link_libraries(MyExecutable Boost::Boost)

重要对比：include_directories vs target_include_directories

特性	`include_directories()`	`target_include_directories()`
作用范围	全局，影响所有目标	仅作用于指定目标
现代 CMake 推荐	❌ 不推荐	✅ 推荐使用
可维护性	较差，易污染全局	较好，逻辑清晰
作用域控制	无法精确控制	支持 PUBLIC/PRIVATE/INTERFACE
目标关联性	不关联特定目标	显式关联特定目标

使用建议

推荐使用target_include_directories()
避免使用include_directories()（除非遗留项目）

示例对比

# ❌ 传统方式（不推荐） include_directories(include) # ✅ 现代方式（推荐） target_include_directories(MyTarget PUBLIC include # 使用者也需要 PRIVATE src # 仅内部需要 INTERFACE . # 接口需要 )