CMake是跨平台构建工具,通过CMakeLists.txt生成编译配置。先安装CMake并验证版本,创建项目目录及main.cpp文件,编写CMakeLists.txt指定最低版本、项目名、C++标准并添加可执行文件。采用out-of-source方式在build目录中执行cmake ..和make生成程序,运行输出“Hello from CMake!”。多源文件时可用set定义SOURCES变量统一管理。链接OpenCV等外部库需find_package查找并用target_link_libraries关联。建议始终分离构建目录,设置Release或Debug模式,支持IDE项目生成,大型项目使用add_subdirectory模块化管理。

在C++开发中,CMake 是一个跨平台的构建系统生成器,能帮助你管理项目的编译过程。它不直接编译代码,而是根据 CMakeLists.txt 文件生成适用于不同构建工具(如 make、ninja、Visual Studio)的配置文件。下面是一个实用的 CMake 使用教程,带你从零开始构建一个简单的 C++ 项目。
1. 安装 CMake
确保你的系统已安装 CMake:
-
Linux(Ubuntu/Debian):
sudo apt install cmake -
macOS(使用 Homebrew):
brew install cmake - Windows:下载安装包从 cmake.org,或使用 vcpkg、MSYS2 等工具安装。
验证安装:cmake --version
2. 创建一个简单 C++ 项目结构
建立如下目录结构:
立即学习“C++免费学习笔记(深入)”;
my_project/ ├── CMakeLists.txt └── main.cpp
编写 main.cpp:
#includeint main() { std::cout << "Hello from CMake!" << std::endl; return 0; }
3. 编写 CMakeLists.txt
在项目根目录创建 CMakeLists.txt,内容如下:
# 指定 CMake 最低版本 cmake_minimum_required(VERSION 3.10)项目名称和可选语言
project(MyApp LANGUAGES CXX)
设置 C++ 标准(例如 C++17)
set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON)
添加可执行文件,名称为 myapp,由 main.cpp 构建
add_executable(myapp main.cpp)
说明:
- cmake_minimum_required:避免使用过旧版本 CMake 导致兼容问题。
- project:定义项目名,LANGUAGES CXX 表示只使用 C++。
- set(CMAKE_CXX_STANDARD ...):指定 C++ 版本,推荐 14、17 或 20。
- add_executable:将源文件编译成可执行程序。
4. 构建项目(推荐使用 out-of-source 构建)
在项目目录下执行:
mkdir build cd build cmake .. make
解释:
-
mkdir build:创建独立的构建目录,避免污染源码。 -
cmake ..:在 build 目录运行 cmake,读取上层的 CMakeLists.txt,生成 Makefile。 -
make:调用编译器实际构建项目。
完成后,在 build/ 目录下会生成可执行文件 myapp,运行它:./myapp
输出:Hello from CMake!
5. 添加多个源文件
如果项目有多个 .cpp 文件,比如:
my_project/ ├── CMakeLists.txt ├── main.cpp ├── utils.cpp └── utils.h
修改 CMakeLists.txt:
add_executable(myapp main.cpp utils.cpp)
或者更清晰地使用变量:
set(SOURCES
main.cpp
utils.cpp
)
add_executable(myapp ${SOURCES})
6. 链接外部库(以 OpenCV 为例)
假设你想使用 OpenCV:
find_package(OpenCV REQUIRED)add_executable(myapp main.cpp) target_link_libraries(myapp ${OpenCV_LIBS})
注意:target_link_libraries 是现代 CMake 推荐方式,比全局链接更安全。
7. 常见技巧与建议
- 始终使用 out-of-source 构建:避免生成文件混入源码。
-
设置调试或发布模式:
cmake .. -DCMAKE_BUILD_TYPE=Release -
支持 IDE:CMake 可生成 Visual Studio 或 Xcode 项目:
cmake -G "Visual Studio 16 2019" .. - 模块化组织:大型项目可用 add_subdirectory 分模块管理。
基本上就这些。掌握 CMake 的核心是理解 CMakeLists.txt 的语法和构建流程。从简单项目入手,逐步添加功能,就能高效管理复杂的 C++ 工程。











