使用CMake可跨平台构建C++项目。首先创建包含src和include目录的项目结构,编写CMakeLists.txt指定项目名称、C++17标准及源文件,添加target_include_directories包含头文件路径,在main.cpp和utils.cpp中实现代码并声明函数,更新CMakeLists.txt加入utils.cpp,接着在build目录执行cmake ..生成构建文件,运行cmake --build .编译后执行可执行文件验证输出。通过target_link_libraries、if条件、target_compile_options等指令可扩展库链接、平台判断与编译优化,实现灵活的跨平台构建管理。

使用CMake构建C++项目是现代C++开发中的常见做法。它能跨平台生成对应的构建系统文件(如Makefile、Visual Studio工程等),让项目更易于编译和维护。下面是一个简单清晰的C++ CMake项目构建教程。
1. 准备项目结构
一个典型的C++项目结构如下:
my_project/├── CMakeLists.txt
├── src/
│ └── main.cpp
└── include/
└── utils.h
确保你已经安装了CMake和一个C++编译器(如g++、clang或MSVC)。
2. 编写CMakeLists.txt
在项目根目录创建 CMakeLists.txt,内容如下:
立即学习“C++免费学习笔记(深入)”;
cmake_minimum_required(VERSION 3.10)# 项目名称和版本
project(MyApp 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)3. 编写简单的C++代码示例
在 src/main.cpp 中写一段测试代码:
#include iostream>#include "utils.h"
int main() {
std::cout printMessage();
return 0;
}
在 include/utils.h 中定义函数:
#ifndef UTILS_H#define UTILS_H
void printMessage();
#endif
并在 src 目录下添加 utils.cpp:
#include "utils.h"#include
void printMessage() {
std::cout }
然后更新 CMakeLists.txt,把新源文件加进去:
add_executable(${PROJECT_NAME}src/main.cpp
src/utils.cpp
)
4. 构建项目
打开终端,进入项目根目录,执行以下命令:
# 创建构建目录(推荐隔离构建)mkdir build
cd build
# 生成Makefile(或其他构建系统)
cmake ..
# 编译项目
cmake --build .
构建成功后,会在 build 目录生成可执行文件 MyApp,运行它:
./MyApp你应该看到输出:
Hello from CMake!This is from utils!
5. 常见配置说明
你可以根据需要扩展 CMakeLists.txt:
- 链接库:使用 target_link_libraries(target_name library)
- 条件编译:用 if(WIN32) 或 if(UNIX) 区分平台
- 编译选项:用 target_compile_options 添加警告或优化参数
- 子目录支持:用 add_subdirectory(lib) 管理模块化项目
基本上就这些。CMake的核心是描述“要构建什么”和“如何构建”,写好CMakeLists.txt后,就能在不同平台上轻松编译你的C++项目。











