初学者如何编写一个简单的CMakeLists.txt文件来编译C++项目-C++-PHP中文网

答案：编写CMakeLists.txt需明确项目名称、源文件及生成目标。基础配置包含cmake_minimum_required指定CMake版本，project定义项目名，add_executable生成可执行文件。例如编译main.cpp为my_app，只需三行命令。对于外部库，使用find_package查找依赖，target_include_directories添加头文件路径，target_link_libraries链接库文件。项目结构复杂时，通过add_subdirectory管理子目录模块，实现源文件分离。指定C++标准可用set(CMAKE_CXX_STANDARD)并设置标准强制启用，结合target_compile_options使用生成器表达式按构建类型添加编译选项，实现灵活控制。

初学者如何编写一个简单的cmakelists.txt文件来编译c++项目

编写一个简单的CMakeLists.txt文件来编译C++项目，对初学者而言，核心在于明确项目名称、指定源文件，并最终生成可执行程序。最基础的配置通常只需三到五行代码，它就像是给编译器和构建系统写的一份“说明书”，告诉它们你的代码在哪里，叫什么名字，最终要变成什么样子。理解这一点，上手CMake就没那么神秘了。

解决方案

我记得我刚开始接触CMake的时候，面对那些复杂的配置选项也感到头大。但其实，对于一个简单的C++项目，比如一个经典的“Hello World”，CMakeLists.txt可以非常简洁。我们从一个最基础的例子开始：

假设你有一个

main.cpp

登录后复制

文件，内容是：

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

#include <iostream>

int main() {
    std::cout << "Hello, CMake!" << std::endl;
    return 0;
}

登录后复制

那么，对应的

CMakeLists.txt

登录后复制

可以这样写：

# 声明所需的CMake最低版本，这是一个好习惯
cmake_minimum_required(VERSION 3.10)

# 定义项目名称，这会影响生成的VS解决方案名或者其他构建系统的名称
project(MyHelloWorld CXX)

# 添加一个可执行目标，参数是目标名称和源文件
add_executable(my_app main.cpp)

登录后复制

就这几行，是不是比想象中简单？

cmake_minimum_required(VERSION 3.10)

登录后复制

：这行是告诉CMake，你的配置需要至少3.10版本的CMake才能正确解析。它避免了在旧版CMake上出现不兼容的问题。

project(MyHelloWorld CXX)

登录后复制

：这里我们给项目起了个名字叫

MyHelloWorld

登录后复制

，并且声明这是一个C++项目（

CXX

登录后复制

）。CMake会用这个名字来生成构建文件。

add_executable(my_app main.cpp)

登录后复制

：这是最关键的一行。它告诉CMake，我们要从

main.cpp

登录后复制

这个源文件编译出一个名为

my_app

登录后复制

的可执行程序。

要编译这个项目，你通常会在项目根目录下创建一个

build

登录后复制

目录，然后进入

build

登录后复制

目录执行：

mkdir build
cd build
cmake ..
make # 或者在Windows上用Visual Studio打开生成的解决方案文件

登录后复制

cmake ..

登录后复制

会根据

CMakeLists.txt

登录后复制

生成特定于你操作系统的构建文件（比如Makefile或Visual Studio项目文件）。

make

登录后复制

（或

ninja

登录后复制

等）就是执行编译过程，最终你会在

build

登录后复制

目录下找到

my_app

登录后复制

可执行文件。

初学者很容易犯的错误就是忘记在

build

登录后复制

目录里运行

cmake ..

登录后复制

，或者路径不对。记住，

..

登录后复制

表示上一级目录，也就是

CMakeLists.txt

登录后复制

所在的目录。

CMake中如何添加外部库和头文件路径？

当你的C++项目开始变得复杂，需要依赖一些外部库，比如Boost、OpenCV或者你自己的某个工具库时，仅仅

add_executable

登录后复制

就不够了。这时，我们需要告诉CMake去哪里找这些库的头文件和二进制文件。这通常涉及

find_package

登录后复制

、

target_include_directories

登录后复制

和

target_link_libraries

登录后复制

这三个命令。

假设我们有一个自定义的静态库

mylib

登录后复制

，它提供了

mylib.h

登录后复制

和

libmylib.a

登录后复制

（或

.lib

登录后复制

），并且它们在项目根目录下的

lib

登录后复制

和

include

登录后复制

子目录里。

首先，在

CMakeLists.txt

登录后复制

中，你需要告诉CMake头文件在哪里：

# ... (之前的 cmake_minimum_required 和 project) ...

# 告诉CMake去哪里找头文件
target_include_directories(my_app PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/include)

# 告诉CMake去哪里找库文件，并链接到你的可执行文件
target_link_libraries(my_app ${CMAKE_CURRENT_SOURCE_DIR}/lib/mylib.a)

登录后复制

这里的

target_include_directories(my_app PUBLIC ...)

登录后复制

表示

my_app

登录后复制

这个目标需要从指定路径下寻找头文件。

PUBLIC

登录后复制

关键字意味着这个头文件路径不仅对

my_app

登录后复制

本身可见，如果其他目标依赖

my_app

登录后复制

，它们也能看到这个路径。

CMAKE_CURRENT_SOURCE_DIR

登录后复制

是一个内置变量，代表当前

CMakeLists.txt

登录后复制

文件所在的目录。

对于更复杂的、系统级的库，比如Boost或者OpenCV，CMake通常有内置的

find_package

登录后复制

模块。比如，如果你想使用Boost的

system

登录后复制

组件：

find_package(Boost COMPONENTS system REQUIRED)
if (Boost_FOUND)
    message(STATUS "Found Boost: ${Boost_LIBRARIES}")
    target_include_directories(my_app PUBLIC ${Boost_INCLUDE_DIRS})
    target_link_libraries(my_app PUBLIC ${Boost_LIBRARIES})
else()
    message(FATAL_ERROR "Boost system component not found!")
endif()

登录后复制

find_package(Boost COMPONENTS system REQUIRED)

登录后复制

会尝试在你的系统上找到Boost库，并确保

system

登录后复制

组件可用。如果找到，它会设置

Boost_INCLUDE_DIRS

登录后复制

和

Boost_LIBRARIES

登录后复制

等变量，我们就可以直接用这些变量来链接。这种方式更优雅，也更跨平台，因为它不需要你硬编码库的路径。

C++项目源文件分散，CMakeLists.txt应该怎么组织？

MagicStudio

图片处理必备效率神器！为你的图片提供神奇魔法

102

查看详情

随着项目规模的增长，把所有源文件都堆在一个目录里，或者在

add_executable

登录后复制

里列出几十个源文件，显然不是个好主意。项目结构应该清晰，模块化。CMake提供了

add_subdirectory

登录后复制

和一些其他策略来管理分散的源文件。

最推荐的方式是使用

add_subdirectory

登录后复制

来组织你的项目。想象一下，你的项目有

src

登录后复制

目录存放主要代码，

lib

登录后复制

目录存放一个自定义的静态库。

项目结构可能如下：

MyProject/
├── CMakeLists.txt         # 根CMakeLists.txt
├── src/
│   ├── CMakeLists.txt     # src目录的CMakeLists.txt
│   └── main.cpp
└── lib/
    ├── CMakeLists.txt     # lib目录的CMakeLists.txt
    ├── mylib.h
    └── mylib.cpp

登录后复制

在

MyProject/CMakeLists.txt

登录后复制

中：

cmake_minimum_required(VERSION 3.10)
project(MyComplexProject CXX)

# 添加lib子目录，它会处理mylib的构建
add_subdirectory(lib)

# 添加src子目录，它会处理my_app的构建，并链接mylib
add_subdirectory(src)

登录后复制

在

MyProject/lib/CMakeLists.txt

登录后复制

中：

# 创建一个静态库目标
add_library(mylib STATIC mylib.cpp mylib.h)

# 确保mylib的头文件对外部可见，以便src目录能找到
target_include_directories(mylib PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})

登录后复制

在

MyProject/src/CMakeLists.txt

登录后复制

中：

# 创建可执行文件
add_executable(my_app main.cpp)

# 链接mylib库
target_link_libraries(my_app PRIVATE mylib)

登录后复制

这样，每个子目录都有自己的

CMakeLists.txt

登录后复制

来定义如何构建该模块，而根目录的

CMakeLists.txt

登录后复制

则负责协调这些子模块。

add_subdirectory

登录后复制

会递归地处理子目录中的

CMakeLists.txt

登录后复制

文件。这种结构非常清晰，易于维护和扩展。

你可能还会看到

aux_source_directory(<dir> <variable>)

登录后复制

，它会查找指定目录下的所有源文件并将其存储在一个变量中。但我个人不推荐过度使用它，因为它可能导致在添加新文件时CMake不会自动重新配置，除非你手动删除

CMakeCache.txt

登录后复制

。明确列出源文件，或者利用

add_subdirectory

登录后复制

来模块化管理，通常是更好的实践。

如何在CMake中指定C++标准和编译器优化选项？

现代C++开发通常会指定一个特定的C++标准（如C++11, C++17, C++20），并且根据需要设置不同的编译器优化级别。CMake也提供了非常直观的方式来处理这些。

要指定C++标准，你可以在

CMakeLists.txt

登录后复制

中这样做：

cmake_minimum_required(VERSION 3.10)
project(MyModernCppProject CXX)

# 指定C++标准为C++17
set(CMAKE_CXX_STANDARD 17)
# 确保编译器必须支持C++17，如果不支持则报错
set(CMAKE_CXX_STANDARD_REQUIRED ON)
# 禁用编译器扩展，强制使用标准C++17特性
set(CMAKE_CXX_EXTENSIONS OFF)

add_executable(my_app main.cpp)

登录后复制

通过

set(CMAKE_CXX_STANDARD 17)

登录后复制

，你告诉CMake你的项目需要C++17标准。

CMAKE_CXX_STANDARD_REQUIRED ON

登录后复制

则让CMake在编译器不支持该标准时直接报错，而不是默默地使用一个旧标准。

CMAKE_CXX_EXTENSIONS OFF

登录后复制

则确保编译器不会使用非标准的语言扩展，这有助于提高代码的可移植性。

至于编译器优化选项，这通常与构建类型（Debug, Release, RelWithDebInfo, MinSizeRel）相关。CMake默认会根据构建类型设置一些优化标志。例如，在Release模式下，通常会自动启用

-O3

登录后复制

等优化。但你也可以为特定的目标添加自定义的编译选项：

# ... (之前的配置) ...

add_executable(my_app main.cpp)

# 为my_app目标添加特定的编译选项
# 比如，在Debug模式下添加更多警告，在Release模式下添加特定的优化
target_compile_options(my_app PUBLIC
    $<$<CONFIG:Debug>:-Wall -Wextra> # Debug模式下启用更多警告
    $<$<CONFIG:Release>:-O3 -DNDEBUG> # Release模式下启用O3优化并定义NDEBUG
)

登录后复制

这里使用了CMake的“生成器表达式”（Generator Expressions），它允许你根据构建配置（