使用CMake构建C++项目可实现跨平台编译与清晰的项目结构。1. 创建项目目录project/,包含src/main.cpp和CMakeLists.txt;2. 在main.cpp中编写简单输出程序;3. 编写CMakeLists.txt,设置最低版本、项目信息、C++17标准,并通过add_executable将源文件编译为hello可执行文件;4. 终端进入项目根目录,创建build目录进行外部构建,运行cmake ..生成构建文件,再执行make编译;5. 运行./hello输出Hello, CMake!;6. 项目扩展时可通过set(SOURCES)收集多个源文件,include_directories添加头文件路径,便于管理复杂结构。核心是编写CMakeLists.txt并采用分离构建目录以提升可维护性。

使用CMake构建C++项目是现代C++开发中的常见做法。它能跨平台管理编译过程,让项目结构更清晰、可维护性更强。下面介绍如何从零开始用CMake构建一个简单的C++项目。
1. 准备项目结构
首先创建一个基本的项目目录结构:
- project/
- src/
- main.cpp
- CMakeLists.txt
在 src/main.cpp 中写一个简单的C++程序:
#include <iostream>
<p>int main() {
std::cout << "Hello, CMake!" << std::endl;
return 0;
}</p>2. 编写 CMakeLists.txt
CMake的核心是 CMakeLists.txt 文件,放在项目根目录下。内容如下:
立即学习“C++免费学习笔记(深入)”;
cmake_minimum_required(VERSION 3.10) <h1>项目名称和版本</h1><p>project(MyCppProject VERSION 1.0)</p><h1>指定C++标准</h1><p>set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON)</p><h1>添加可执行文件,指定源文件路径</h1><p>add_executable(hello src/main.cpp)</p>
说明:
- cmake_minimum_required:声明所需最低CMake版本。
- project:定义项目名称和元信息。
- CMAKE_CXX_STANDARD:设置C++17标准,可根据需要改为14或20。
- add_executable:将源文件编译为名为 hello 的可执行程序。
3. 构建项目
打开终端,进入项目根目录,执行以下命令:
# 创建构建目录(推荐使用 out-of-source 构建)
mkdir build
cd build
<h1>生成 Makefile 或其他构建系统文件</h1><p>cmake ..</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/ai/1188" title="Fotor"><img
src="https://img.php.cn/upload/ai_manual/001/431/639/68b7ae8a10183155.png" alt="Fotor" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/ai/1188" title="Fotor">Fotor</a>
<p>Fotor 在线照片编辑器</p>
</div>
<a href="/ai/1188" title="Fotor" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><h1>编译项目</h1><p>make</p>成功后会在 build/ 目录下生成可执行文件 hello,运行它:
./hello # 输出:Hello, CMake!
4. 添加多个源文件或子目录
如果项目变大,可以组织成多个源文件或子目录。例如:
- src/main.cpp
- src/utils.cpp
- include/utils.h
修改 CMakeLists.txt:
cmake_minimum_required(VERSION 3.10)
project(MyCppProject VERSION 1.0)
<p>set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)</p><h1>添加头文件搜索路径</h1><p>include_directories(include)</p><h1>使用变量收集源文件(可读性更好)</h1><p>set(SOURCES
src/main.cpp
src/utils.cpp
)</p><p>add_executable(hello ${SOURCES})</p>这样就能轻松管理多个文件。
基本上就这些。CMake功能强大,支持静态库、动态库、测试、依赖管理等高级特性,但以上内容已足够启动大多数中小型C++项目。关键是写好 CMakeLists.txt 并保持构建目录分离,项目会更整洁。不复杂但容易忽略。









