CMake构建C++项目核心三步:写CMakeLists.txt(含cmake_minimum_required、project、add_executable)、在build目录中运行cmake生成本地构建文件、用make/ninja/cmake--build编译运行。

用 CMake 构建 C++ 项目,核心就三步:写 CMakeLists.txt、生成构建文件、编译运行。它不直接编译代码,而是生成 Makefile(Linux/macOS)或 Visual Studio 工程(Windows)等本地构建系统所需的配置,真正跨平台的关键就在这儿。
写好 CMakeLists.txt:项目的“蓝图”
这是 CMake 的入口文件,放在项目根目录。最简结构只需三行:
- cmake_minimum_required(VERSION 3.10) —— 声明最低 CMake 版本,避免语法不兼容
- project(MyApp LANGUAGES CXX) —— 定义项目名和语言(CXX 表示 C++)
- add_executable(MyApp main.cpp) —— 指定可执行文件名和源文件
如果用了头文件、多个源码或第三方库,再加 include_directories()、target_include_directories()(推荐)、find_package() 或 target_link_libraries() 即可。注意:路径尽量用相对路径,别写死绝对路径。
生成构建文件:用 cmake 命令“翻译”配置
不要在源码目录里直接运行 cmake,养成新建 build/ 子目录的习惯:
立即学习“C++免费学习笔记(深入)”;
- mkdir build && cd build
- cmake .. —— 默认生成 Unix Makefiles(Linux/macOS)
- cmake -G "Visual Studio 17 2022" .. —— Windows 下生成 VS 工程(版本按实际调整)
- cmake -G "Ninja" .. —— 更快的 Ninja 构建器(需提前安装)
成功后,build 目录里会出现 Makefile、compile_commands.json 或 .sln 等文件,这才是后续编译的依据。
编译与运行:和本地工具链打交道
生成完,就用对应构建工具执行:
- Linux/macOS(Makefiles):make 编译,./MyApp 运行
- Linux/macOS(Ninja):ninja 编译,./MyApp 运行
- Windows(VS):cmake --build . 或直接打开 .sln 用 VS 图形界面编译
- 通用方式(推荐):cmake --build . —— 自动适配当前生成器,不用记 make/ninja/msbuild
想清理?删掉整个 build 目录就行,CMake 没有“make clean”式命令,也不需要。
小技巧:让开发更顺手
- 用 cmake -DCMAKE_BUILD_TYPE=Debug .. 控制构建类型(Debug/Release),影响优化和调试信息
- 第三方库装在系统路径(如 /usr/local)时,加 -DCMAKE_PREFIX_PATH=/usr/local 帮 CMake 找到它
- 编辑 CMakeLists.txt 后,不用删 build 目录重来,直接进 build 目录再运行一次 cmake .. 就能更新配置
- 用 cmake-gui 或 CLion/VS Code 的 CMake 插件,可视化配置变量,适合新手排查问题
基本上就这些。不复杂,但容易忽略目录分离和构建类型设置——这两点踩过坑的人最多。










