C++如何使用CMake构建项目_C++ CMakeLists.txt编写入门教程-C++-PHP中文网

C++如何使用CMake构建项目_C++ CMakeLists.txt编写入门教程

穿越時空

发布： 2025-11-29 13:03:06

原创

283人浏览过

首先给出明确答案，CMake是C++项目中主流的构建系统生成工具，通过编写CMakeLists.txt文件生成跨平台构建文件。具体描述：文章介绍了CMake的基本使用流程，从环境准备、简单项目构建到多文件多目录管理，涵盖编译器与CMake安装验证、最小CMakeLists.txt编写、外部构建目录创建、静态库添加、C++标准设置及target_include_directories等现代CMake最佳实践，并指出其跨平台特性与扩展功能方向。顺序与原文一致，内容完整无截断。

c++如何使用cmake构建项目_c++ cmakelists.txt编写入门教程

C++项目管理中，CMake 是目前最主流的构建系统生成工具之一。它不直接编译代码，而是根据 CMakeLists.txt 文件生成适用于不同平台的构建文件（如 Makefile 或 Visual Studio 工程）。本文将带你从零开始编写一个简单的 CMakeLists.txt，快速上手 C++ 项目的 CMake 构建流程。

1. 准备工作：安装 CMake 和编译器

在使用 CMake 前，请确保你的系统已安装：

一个 C++ 编译器（如 GCC、Clang 或 MSVC）
CMake（建议版本 3.10 以上）

可通过终端运行以下命令验证是否安装成功：

cmake --version
g++ --version

2. 创建最简单的 C++ 项目

假设你的项目结构如下：

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

my_project/
├── CMakeLists.txt
└── main.cpp

先创建 main.cpp：

#include <iostream>

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

然后创建同目录下的 CMakeLists.txt：

cmake_minimum_required(VERSION 3.10)
project(MyProject)

add_executable(myapp main.cpp)

说明：

cmake_minimum_required：指定所需最低 CMake 版本
project：定义项目名称（可选添加 VERSION 和 LANGUAGES）
add_executable：将源文件编译为可执行文件，myapp 是输出的程序名

3. 构建并运行项目

在项目根目录下打开终端，执行：

mkdir build
cd build
cmake ..
cmake --build .

解释：

创建 build 目录用于存放中间文件，避免污染源码（推荐做法）
cmake .. 读取上级目录的 CMakeLists.txt 并生成构建系统
cmake --build . 调用底层构建工具（如 make）编译项目

构建成功后，在 build 目录会生成可执行文件 myapp，运行它：

Quinvio AI

AI辅助下快速创建视频，虚拟代言人

查看详情

./myapp

应输出：Hello from CMake!

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

当项目变大时，通常会组织成多个源文件和子目录。例如：

my_project/
├── CMakeLists.txt
├── main.cpp
├── src/
│ ├── math.cpp
│ └── math.h
└── include/
└── math.h

修改顶层 CMakeLists.txt：

cmake_minimum_required(VERSION 3.10)
project(MyProject)

# 指定头文件搜索路径
include_directories(include)

# 添加可执行文件
add_executable(myapp main.cpp src/math.cpp)

如果你希望模块化管理 src 目录，可以添加子 CMakeLists.txt：

# my_project/src/CMakeLists.txt
add_library(math_lib STATIC math.cpp)

然后在主 CMakeLists.txt 中包含该目录：

cmake_minimum_required(VERSION 3.10)
project(MyProject)

include_directories(include)
add_subdirectory(src)

add_executable(myapp main.cpp)
target_link_libraries(myapp math_lib)

这里使用了：