C++如何使用CMake构建项目_C++跨平台编译工具CMakeLists.txt入门

使用CMake可实现跨平台C++项目构建。1. 编写CMakeLists.txt定义项目：指定最低版本、项目名、C++标准，并用add_executable添加源文件；2. 多文件可用变量集合简化；3. 通过target_include_directories添加头文件路径；4. 推荐外部构建，执行mkdir build && cd build && cmake .. && make生成并编译；5. 使用find_package或find_library链接第三方库；6. 通过-DCMAKE_BUILD_TYPE=Debug/Release切换构建模式，自动应用对应编译选项。掌握基础后可扩展至复杂项目结构。

使用CMake构建C++项目是现代开发中的常见做法，尤其适合跨平台项目。CMake并不直接编译代码，而是根据CMakeLists.txt生成对应平台的构建配置，比如Makefile、Visual Studio工程等，从而实现“一次编写，多平台构建”。

1. 准备 CMakeLists.txt 文件

每个CMake项目都需要一个CMakeLists.txt文件，放在项目根目录下，定义项目的结构和构建规则。

最简单的CMakeLists.txt示例：

cmake_minimum_required(VERSION 3.10)
project(MyApp)

set(CMAKE_CXX_STANDARD 14)

add_executable(myapp main.cpp)

说明：

• cmake_minimum_required：指定所需最低CMake版本。
• project：定义项目名称，也可设置语言（默认包含CXX）。
• set(CMAKE_CXX_STANDARD 14)：设置C++标准为C++14，可改为17或20。
• add_executable：将main.cpp编译成名为myapp的可执行文件。

2. 多文件项目组织

如果项目有多个源文件，可以全部列在add_executable中：

add_executable(myapp
    main.cpp
    utils.cpp
    calculator.cpp
)

也可以用变量简化：

set(SOURCES
    main.cpp
    utils.cpp
    calculator.cpp
)
add_executable(myapp ${SOURCES})

3. 添加头文件目录

若头文件不在源文件同目录，需用target_include_directories指定搜索路径：

target_include_directories(myapp PRIVATE include)

这会让编译器在include/目录中查找#include的头文件。PRIVATE表示该路径仅用于此目标。

4. 构建项目（命令行方式）

推荐使用外部构建（out-of-source），避免生成文件污染源码目录：

mkdir build
cd build
cmake ..
make

Windows上若使用Visual Studio，可运行：

cmake -G "Visual Studio 16 2019" ..

然后打开生成的.sln文件。

5. 链接库文件

若项目依赖静态库或动态库，可用target_link_libraries链接：

find_library(MATH_LIB m REQUIRED)
target_link_libraries(myapp ${MATH_LIB})

对于第三方库如Boost、OpenCV，CMake提供find_package：

find_package(OpenCV REQUIRED)
include_directories(${OpenCV_INCLUDE_DIRS})
target_link_libraries(myapp ${OpenCV_LIBS})

6. 支持调试与发布版本

CMake默认支持多配置模式。生成时可通过-DCMAKE_BUILD_TYPE指定：

cmake -DCMAKE_BUILD_TYPE=Release ..
cmake -DCMAKE_BUILD_TYPE=Debug ..

不同模式会自动应用对应的编译选项，如-O2优化或带调试符号。