CMake是C++项目跨平台构建的关键工具，通过编写CMakeLists.txt生成适配不同环境的构建配置。首先安装CMake并验证版本，创建项目后编写简单main.cpp和CMakeLists.txt，使用cmake_minimum_required、project、add_executable定义基本构建逻辑。推荐在build目录中进行外部构建，执行mkdir build && cd build && cmake .. && make完成编译运行。项目扩展时可添加src和include子目录，用add_library创建静态库，target_link_libraries实现链接，并建议用target_include_directories替代全局include_directories以提升模块化。还可设置set(CMAKE_CXX_STANDARD 17)指定C++标准，使用-DCMAKE_BUILD_TYPE=Debug生成调试版本。掌握这些基础即可高效组织和构建C++项目。

在C++开发中，CMake是一个跨平台的构建系统生成工具，它不直接编译代码，而是根据CMakeLists.txt文件生成适用于不同编译环境（如Makefile、Ninja、Visual Studio项目等）的构建配置。对于初学者来说，掌握如何使用CMake来组织和构建C++项目是提升开发效率的重要一步。

1. 安装CMake

在开始之前，确保你的系统已安装CMake：

• Windows：可从官网下载安装包，或使用vcpkg、choco等工具安装。
• macOS：使用Homebrew执行 brew install cmake。
• Linux（Ubuntu/Debian）：运行 sudo apt install cmake。

安装完成后，在终端输入 cmake –version 验证是否成功。

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

新建一个项目目录，例如 my_cpp_project，结构如下：

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

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

编辑 main.cpp：

#include <iostream>
int main() {
std::cout << “Hello, CMake!” << std::endl;
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：将源文件编译为可执行程序。

3. 构建并运行项目

在项目根目录下操作：

Asksia

Asksia AI – 最好的AI老师，可靠的作业助手

48

查看详情

mkdir build
cd build
cmake ..
make

解释：

• 创建 build 目录用于存放编译产物，避免污染源码目录（推荐做法）。
• cmake .. 读取上级目录的 CMakeLists.txt 并生成构建系统（这里是Makefile）。
• make 执行编译，生成可执行文件 hello（Linux/macOS）或 hello.exe（Windows）。

运行程序：./hello，输出：Hello, CMake!

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

当项目变大时，需要管理多个源文件。示例结构：

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

修改根目录 CMakeLists.txt：

cmake_minimum_required(VERSION 3.10)
project(Myapp VERSION 1.0)

# 链接库
target_link_libraries(myapp math_lib)

其中 math.cpp 可包含简单函数，如加法实现。通过 target_link_libraries 将库链接到主程序。

5. 常用技巧与建议

以下是实际开发中的实用做法：

• 始终使用 build 目录进行外部构建。
• 使用 target_include_directories() 替代全局 include_directories()，更安全：

target_include_directories(math_lib PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/include)

• 设置C++标准：

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

• 调试构建：使用 cmake -DCMAKE_BUILD_TYPE=Debug .. 生成带调试信息的版本。

基本上就这些。CMake入门并不复杂，但功能强大。从简单的单文件项目开始，逐步掌握多文件、库链接、编译选项等常用功能，就能高效管理自己的C++项目了。