c++ 怎么使用CMake来构建项目_c++项目构建工具CMake使用教程-C++-PHP中文网

c++ 怎么使用CMake来构建项目_c++项目构建工具CMake使用教程

裘德小鎮的故事

发布： 2025-11-10 11:31:04

原创

634人浏览过

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来构建项目_c++项目构建工具cmake使用教程

在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：

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

登录后复制

3. 编写 CMakeLists.txt

在项目根目录创建 CMakeLists.txt，内容如下：

# 指定 CMake 最低版本
cmake_minimum_required(VERSION 3.10)
<h1>项目名称和可选语言</h1><p>project(MyApp LANGUAGES CXX)</p><h1>设置 C++ 标准（例如 C++17）</h1><p>set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)</p><h1>添加可执行文件，名称为 myapp，由 main.cpp 构建</h1><p>add_executable(myapp main.cpp)</p>

登录后复制

说明：

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
)
<p>add_executable(myapp ${SOURCES})</p>

登录后复制

6. 链接外部库（以 OpenCV 为例）

假设你想使用 OpenCV：

find_package(OpenCV REQUIRED)
<p>add_executable(myapp main.cpp)
target_link_libraries(myapp ${OpenCV_LIBS})</p>

登录后复制

注意：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++ 工程。

以上就是c++++ 怎么使用CMake来构建项目_c++项目构建工具CMake使用教程的详细内容，更多请关注php中文网其它相关文章！