c++中如何使用CMake构建项目_CMake跨平台构建系统入门教程-C++-PHP中文网

c++中如何使用CMake构建项目_CMake跨平台构建系统入门教程

冰火之心

发布： 2025-09-28 09:09:02

原创

454人浏览过

CMake通过编写CMakeLists.txt实现跨平台构建，首先安装并验证CMake环境，然后创建项目文件和源码，使用外部构建目录执行cmake生成构建文件并编译。1. 编写基础配置：指定最低版本、项目名、C++标准及可执行文件；2. 多文件管理：通过add_executable添加多个源文件或使用aux_source_directory收集子目录源码，结合add_subdirectory和target_link_libraries组织库依赖；3. 第三方库集成：用find_package查找系统库如Boost，或通过FetchContent引入外部库如fmt。最终实现清晰高效的C++项目构建流程。

c++中如何使用cmake构建项目_cmake跨平台构建系统入门教程

C++中使用CMake构建项目，核心在于编写清晰的CMakeLists.txt文件，并利用CMake工具链实现跨平台编译。CMake不直接编译代码，而是根据配置生成对应平台的构建文件（如Makefile、Visual Studio工程等），从而实现“一次配置，多平台构建”。

1. 安装CMake并验证环境

在开始前，确保系统已安装CMake。大多数Linux发行版可通过包管理器安装：

Ubuntu/Debian: sudo apt install cmake
CentOS/RHEL: sudo yum install cmake 或使用dnf

macOS用户可用Homebrew：

brew install cmake

Windows推荐从官网下载安装包，安装时勾选“添加到系统PATH”。

立即学习“C++免费学习笔记（深入）”；

安装完成后，在终端执行：

cmake --version

若显示版本号，说明安装成功。

2. 编写基础CMakeLists.txt

创建项目目录，例如my_cpp_project，并在其中新建CMakeLists.txt文件。一个最简单的C++项目配置如下：

cmake_minimum_required(VERSION 3.10)
project(MyApp)
<p>set(CMAKE_CXX_STANDARD 17)</p><p>add_executable(hello main.cpp)</p>

登录后复制

说明：

即构数智人

即构数智人是由即构科技推出的AI虚拟数字人视频创作平台，支持数字人形象定制、短视频创作、数字人直播等。

查看详情

cmake_minimum_required：指定所需最低CMake版本
project：定义项目名称，可附带语言和版本信息
set(CMAKE_CXX_STANDARD 17)：要求使用C++17标准
add_executable：将main.cpp编译为可执行文件hello

3. 创建源码并构建项目

在项目根目录下创建main.cpp：

#include <iostream>
int main() {
    std::cout << "Hello from CMake!" << std::endl;
    return 0;
}

登录后复制

接下来进行构建。建议使用外部构建目录，避免污染源码：

mkdir build && cd build
cmake .. # 读取上级目录的CMakeLists.txt
make # 调用生成的Makefile编译（Windows上可用cmake --build .）

构建成功后，运行./hello即可看到输出。

4. 添加多个源文件与子目录

当项目变大时，可组织成多个源文件。例如添加src/utils.cpp和include/utils.h：

# 在CMakeLists.txt中
add_executable(hello
    main.cpp
    src/utils.cpp
)
target_include_directories(hello PRIVATE include)

登录后复制

若使用子目录管理，可在src/CMakeLists.txt中使用aux_source_directory自动收集源文件：

aux_source_directory(. SRC_FILES)
add_library(mylib ${SRC_FILES})

登录后复制

然后在主CMakeLists.txt中通过add_subdirectory(src)引入，并用target_link_libraries(hello mylib)链接静态库。

5. 处理依赖与第三方库

CMake支持通过find_package查找系统库。例如使用Boost：

find_package(Boost REQUIRED COMPONENTS system filesystem)
if(Boost_FOUND)
    target_link_libraries(hello ${Boost_LIBRARIES})
    target_include_directories(hello PRIVATE ${Boost_INCLUDE_DIRS})
endif()

登录后复制

对于非系统库，可使用FetchContent自动下载并集成：

include(FetchContent)
FetchContent_Declare(
  fmt
  GIT_REPOSITORY https://github.com/fmtlib/fmt.git
  GIT_TAG        8.1.1
)
FetchContent_MakeAvailable(fmt)
target_link_libraries(hello fmt::fmt)

登录后复制

基本上就这些。掌握CMake的核心是理解其声明式语法和构建流程。从简单项目入手，逐步扩展功能，就能高效管理复杂的C++工程。

以上就是c++++中如何使用CMake构建项目_CMake跨平台构建系统入门教程的详细内容，更多请关注php中文网其它相关文章！