c++怎么用CMake来管理项目_c++跨平台构建工具CMake使用教程

落磊小哥_8845

落磊小哥_8845

2025-11-14

696人浏览

原创

CMake是跨平台构建系统生成器,通过CMakeLists.txt生成多平台构建文件。1. 安装:Linux用apt,macOS用brew,Windows从官网下载;2. 项目结构含src、include和CMakeLists.txt;3. 基本语法包括设置版本、项目名、C++标准及添加可执行文件;4. 推荐out-of-source构建,使用mkdir build、cmake ..、make编译;5. 配置头文件路径用target_include_directories,链接库用find_package和target_link_libraries;6. 支持条件判断处理跨平台差异,如WIN32、APPLE、UNIX;7. 现代CMake提倡target_*命令提升模块化;8. 可集成测试与安装规则,enable_testing()和install()实现自动化。掌握这些核心用法即可高效管理跨平台C++项目。

c++怎么用cmake来管理项目_c++跨平台构建工具cmake使用教程

CMake 是一个强大的跨平台构建系统生成器,广泛用于 C++ 项目中。它不直接编译代码,而是根据 CMakeLists.txt 文件生成适用于不同平台的构建文件(如 Makefile、Visual Studio 工程等),从而实现“一次编写,多平台构建”。

1. 安装 CMake

在使用前需确保已安装 CMake:

  • Linux(Ubuntu/Debian):sudo apt install cmake
  • macOS:brew install cmake
  • Windows:从 官网下载安装包,或使用 vcpkg、MSYS2 等工具安装

安装完成后,可通过以下命令验证:

cmake --version

2. 基本项目结构

一个典型的 C++ 项目结构如下:

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

在项目根目录创建 CMakeLists.txt,内容如下:

cmake_minimum_required(VERSION 3.10)<br>
project(MyProject LANGUAGES CXX)<br><br>
# 设置 C++ 标准<br>
set(CMAKE_CXX_STANDARD 17)<br>
set(CMAKE_CXX_STANDARD_REQUIRED ON)<br><br>
# 添加可执行文件<br>
add_executable(${PROJECT_NAME}<br>
    src/main.cpp<br>
)

说明:

  • cmake_minimum_required:指定所需最低 CMake 版本
  • project:定义项目名称和语言
  • set(CMAKE_CXX_STANDARD ...):启用 C++17 支持
  • add_executable:将源文件编译为可执行程序

3. 编译与运行项目

推荐使用 out-of-source 构建方式,避免污染源码目录:

mkdir build<br>
cd build<br>
cmake ..<br>
make

生成后可在 build/ 目录下找到可执行文件 MyProject,运行:

./MyProject

4. 添加头文件目录和库依赖

若项目包含头文件或第三方库,需配置包含路径:

target_include_directories(${PROJECT_NAME} PRIVATE<br>
    ${PROJECT_SOURCE_DIR}/include<br>
)

如果需要链接外部库(例如 Boost 或 OpenCV):

windows-screenshot-ocr
windows-screenshot-ocr

Windows全屏截图(自动标记鼠标位置)+ 原生OCR文字识别。本地运行,无需联网和API Key,适用于截图分析和自动化OCR场景。

下载
find_package(OpenCV REQUIRED)<br>
target_link_libraries(${PROJECT_NAME} PRIVATE ${OpenCV_LIBS})

对于静态或动态库,可使用 add_library 创建:

add_library(mylib STATIC src/mylib.cpp)<br>
target_include_directories(mylib PUBLIC include)<br>
target_link_libraries(${PROJECT_NAME} PRIVATE mylib)

5. 跨平台兼容性处理

CMake 可自动识别平台并做条件判断:

if(WIN32)<br>
    message("Building on Windows")<br>
    add_compile_definitions(IS_WINDOWS)<br>
elseif(APPLE)<br>
    message("Building on macOS")<br>
elseif(UNIX)<br>
    message("Building on Linux")<br>
endif()

也可针对不同构建类型(Debug/Release)设置编译选项:

if(CMAKE_BUILD_TYPE STREQUAL "Debug")<br>
    add_compile_definitions(DEBUG_MODE)<br>
endif()

6. 使用现代 CMake 最佳实践

现代 CMake 推荐使用 target_* 系列命令,而非全局设置:

  • target_include_directories():只为特定目标添加头文件路径
  • target_compile_features():指定目标所需的编译特性
  • target_link_libraries():精确控制库依赖传递

这样可以提升模块化程度,便于大型项目维护。

7. 集成测试与安装

启用测试功能:

enable_testing()<br>
add_test(NAME run_main COMMAND MyProject)

设置安装规则:

install(TARGETS ${PROJECT_NAME}<br>
    DESTINATION bin<br>
)<br>
install(DIRECTORY include/<br>
    DESTINATION include<br>
)

执行安装:

make install

(可指定 CMAKE_INSTALL_PREFIX)

基本上就这些。CMake 功能丰富,但掌握基本语法后就能高效管理大多数 C++ 项目,尤其适合希望支持 Windows、Linux 和 macOS 的跨平台开发场景。

C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!

相关文章

c++速学教程(入门到精通)
c++速学教程(入门到精通)

c++怎么学习?c++怎么入门?c++在哪学?c++怎么学才快?不用担心,这里为大家提供了c++速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.26

3379

3

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.27

2938

6

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

2023.08.01

1528

3

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2679

5

windows无法访问共享电脑
windows无法访问共享电脑

在现代社会中,共享电脑是办公室和家庭的重要组成部分。然而,有时我们可能会遇到Windows无法访问共享电脑的问题。这个问题可能会导致数据无法共享,影响工作和生活的正常进行。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.08

3350

4

windows自动更新
windows自动更新

Windows操作系统的自动更新功能可以确保系统及时获取最新的补丁和安全更新,以提高系统的稳定性和安全性。然而,有时候我们可能希望暂时或永久地关闭Windows的自动更新功能。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

1697

3

windows boot manager
windows boot manager

windows boot manager无法开机的解决方法:1、系统文件损坏,使用Windows安装光盘或USB启动盘进入恢复环境,选择修复计算机,然后选择自动修复;2、引导顺序错误,进入恢复环境,选择命令提示符,输入命令"bootrec /fixboot"和"bootrec /fixmbr",然后重新启动计算机;3、硬件问题,使用硬盘检测工具进行扫描和修复;4、重装操作系统。本专题还提供其他解决

2023.08.28

2517

4

windows锁屏快捷键
windows锁屏快捷键

windows锁屏快捷键是Windows键+L、Ctrl+Alt+Del、Windows键+D、Windows键+P和Windows键+R。本专题为大家提供windows相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.30

5247

5

Window.setInterval()方法
Window.setInterval()方法

Window.setInterval() 方法的基本语法是“window.setInterval(function, delay)”,function是要重复执行的函数或代码块,delay是每次执行之间的时间间隔,以毫秒为单位。本专题为大家提供Window.setInterval()相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

815

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习