C++ CMakeLists.txt编写教程_C++项目构建工具CMake入门

CMake通过CMakeLists.txt生成构建配置，基本语法包括指定版本、项目名、源文件编译为可执行文件。支持多源文件、目录结构、头文件路径设置（include_directories）、静态/动态库创建（add_library）与链接（target_link_libraries），并可设C++标准（如C++17）和编译选项（如-Wall）。核心是“目标”概念，对目标设置属性实现灵活构建管理。

CMake 是一个跨平台的构建系统生成工具，广泛用于 C++ 项目中。它不直接编译代码，而是根据 CMakeLists.txt 文件生成适用于不同构建系统的配置文件（如 Makefile、Ninja、Visual Studio 工程等）。掌握如何编写 CMakeLists.txt 是管理 C++ 项目的必备技能。

创建最简单的 CMakeLists.txt

一个最基本的 C++ 项目只需要一个源文件和对应的 CMake 配置文件。

假设你的项目结构如下：

main.cpp
CMakeLists.txt

在 main.cpp 中写入简单程序：

#include iostream>
int main() {
std::cout return 0;
}

然后创建 CMakeLists.txt：

cmake_minimum_required(VERSION 3.10)
project(HelloCMake)
add_executable(hello main.cpp)

说明：

cmake_minimum_required：指定所需最低 CMake 版本，避免使用过新特性导致兼容问题。
project：定义项目名称，可选地设置语言（默认自动检测为 C 和 C++）。
add_executable：将源文件编译成可执行文件，格式为 add_executable(目标名源文件列表)。

添加多个源文件和目录结构

实际项目通常包含多个源文件。例如：

src/
  main.cpp
  utils.cpp
include/
  utils.h
CMakeLists.txt

修改 CMakeLists.txt 如下：

cmake_minimum_required(VERSION 3.10)
project(MyApp)

# 添加头文件搜索路径
include_directories(include)

# 将多个源文件构建成一个可执行文件
add_executable(myapp src/main.cpp src/utils.cpp)

说明：

include_directories：让编译器能找到 #include "utils.h" 这类引用。
你可以把所有源文件列在 add_executable 后面，也可以用变量简化：

set(SOURCES
src/main.cpp
src/utils.cpp

)
add_executable(myapp ${SOURCES})

链接库文件（静态库或动态库）

如果你有独立的工具库，可以将其构建成静态库再链接到主程序。

目录结构示例：

src/main.cpp
lib/utils.cpp
include/utils.h
CMakeLists.txt

更新后的 CMakeLists.txt：

cmake_minimum_required(VERSION 3.10)
project(MyApp)

include_directories(include)

# 构建静态库
add_library(myutils STATIC lib/utils.cpp)

# 生成可执行文件
add_executable(myapp src/main.cpp)

# 链接库
target_link_libraries(myapp myutils)

说明：

add_library：创建名为 myutils 的静态库（使用 STATIC），也可用 SHARED 创建动态库。
target_link_libraries：指定哪个目标需要链接哪些库。

设置编译选项和标准版本

现代 C++ 项目常使用 C++17 或更高标准。可以在 CMake 中明确指定：

# 设置 C++ 标准
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 或者针对特定目标设置
target_compile_features(myapp PRIVATE cxx_std_17)

你还可以添加警告选项提升代码质量：

if(CMAKE_CXX_COMPILER_ID STREQUAL "GNU" OR
CMAKE_CXX_COMPILER_ID MATCHES "Clang")
target_compile_options(myapp PRIVATE -Wall -Wextra -pedantic)
endif()

基本上就这些。从简单项目开始，逐步加入子目录、外部依赖、条件编译等功能，CMake 能很好地支持大型 C++ 工程的组织与构建。关键是理解“目标”（target）的概念——每个可执行文件或库都是一个目标，对其设置属性（如包含路径、编译选项、链接库）才是推荐做法。

# c++ # app # 工具 # ai # ios # stream # 配置文件 # red # Static # if # include # int # private # visual studio # gnu # 可执行文件 # 多个 # 链接库 # 都是 # 是一个 # 头文件 # 很好 # 你可以 # 才是

返回目录在线咨询

您的项目需求