c++怎么使用CMake来管理一个项目_c++项目构建与跨平台编译配置教程

尼克

发布： 2025-11-17 13:37:49

原创

237人浏览过

首先创建项目结构并编写CMakeLists.txt，然后配置C++标准与头文件路径，接着编写示例代码，通过build目录执行cmake生成构建系统并编译，最后注意跨平台路径与库链接问题。

c++怎么使用cmake来管理一个项目_c++项目构建与跨平台编译配置教程

在现代C++开发中，使用CMake来管理项目已成为标准做法。它能帮助你清晰组织代码结构、简化编译流程，并实现跨平台构建（Windows、Linux、macOS等）。下面是一个实用的C++项目构建与跨平台编译配置教程，带你从零开始使用CMake。

1. 项目基础结构

一个典型的CMake项目目录结构如下：

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

这个结构将源码（src）、头文件（include）和构建配置（CMakeLists.txt）分离，便于维护。

2. 编写根目录 CMakeLists.txt

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

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

cmake_minimum_required(VERSION 3.10)
project(MyProject VERSION 1.0 LANGUAGES CXX)

设置C++标准

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

添加可执行文件

add_executable(${PROJECT_NAME}
src/main.cpp
)

包含头文件目录

target_include_directories(${PROJECT_NAME} PRIVATE include)

说明：

cmake_minimum_required：指定所需最低CMake版本。
project：定义项目名称、版本和语言。
set(CMAKE_CXX_STANDARD ...)：启用C++17标准（也可改为14或20）。
add_executable：将源文件编译为可执行程序。
target_include_directories：让编译器能找到头文件。

3. 示例代码：main.cpp 与头文件

include/my_header.h：

#ifndef MY_HEADER_H
#define MY_HEADER_H

void say_hello();

endif // MY_HEADER_H

无阶未来模型擂台/AI 应用平台

无阶未来模型擂台/AI 应用平台，一站式模型+应用平台

查看详情

src/main.cpp：

#include <iostream>
#include "my_header.h"

void say_hello() {
std::cout << "Hello from CMake!" << std::endl;
}

int main() {
say_hello();
return 0;
}

4. 构建项目（跨平台通用步骤）

打开终端，进入项目根目录，执行以下命令：

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

解释：

mkdir build：创建独立的构建目录（推荐做法，避免污染源码）。
cmake ..：读取上级目录的CMakeLists.txt，生成对应平台的构建系统（如Makefile或Visual Studio工程）。
cmake --build .：调用底层构建工具（make、ninja、MSBuild等）完成编译。

构建成功后，可在build目录下找到生成的可执行文件（如MyProject或MyProject.exe）。

5. 跨平台注意事项

CMake本身是跨平台的，但需注意以下几点：

路径分隔符：使用正斜杠 /，CMake会自动处理不同系统的差异。
编译器兼容性：确保目标平台安装了支持C++17的编译器（g++、clang、MSVC等）。
生成器选择：可通过 -G 指定生成器，例如：
cmake -G "Unix Makefiles" ..
或 Windows 上：
cmake -G "Visual Studio 17 2022" ..

6. 引入第三方库（以静态库为例）

假设你有一个第三方库 libmath.a 和对应的头文件：

# 在CMakeLists.txt中添加
add_library(math STATIC IMPORTED)
set_property(TARGET math PROPERTY IMPORTED_LOCATION /path/to/libmath.a)
target_include_directories(math INTERFACE /path/to/math_headers)