C++ Academy · 课时

CMake 项目布局与 CMakeLists.txt

Q: 「CMake 项目布局与 CMakeLists.txt」这节课中我会学到什么？

规划源代码树，并编写基础的 CMakeLists.txt 文件 你通过在浏览器中直接运行的动手代码来练习 C++ Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

规划源代码树，并编写基础的 CMakeLists.txt 文件

第 1 / 4 课14 个步骤

CMake 项目布局与 CMakeLists.txt 是 CoddyKit 上的免费 C++ Academy 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 C++ Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 C++ Academy 课程共包含 4 节课。

为什么使用 CMake

CMake 是 C++ 事实上的标准构建系统生成器。它可以根据单一描述，为 Make、Ninja、Visual Studio 和 Xcode 生成项目文件。

最小 CMakeLists.txt

对于单个可执行文件，最小但实用的 CMakeLists.txt。

cmake_minimum_required(VERSION 3.20)
project(MyApp LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

add_executable(myapp main.cpp)

源代码外构建

请始终在单独的目录中构建，以保持源代码树整洁。

# from project root
cmake -B build
cmake --build build

标准项目布局

一种清晰的结构：

CMakeLists.txt
src/ — 源文件
include/ — 公共头文件
tests/ — 测试
third_party/ — 捆绑的依赖项

添加子目录

递归进入包含各自 CMakeLists.txt 的子目录。

# top-level
add_subdirectory(src)
add_subdirectory(tests)

变量和属性

使用 set 设置变量。使用 ${var} 读取变量。常见变量包括：CMAKE_BUILD_TYPE、CMAKE_CXX_FLAGS。

set(CMAKE_BUILD_TYPE Release)
set(SOURCES src/a.cpp src/b.cpp)

动态查找文件

可以使用 file(GLOB ...) 快速创建原型。对于生产环境，请显式列出源文件，以便添加文件时 CMake 重新运行。

# Discouraged for production
file(GLOB SOURCES "src/*.cpp")

# Preferred
add_executable(myapp src/main.cpp src/util.cpp)

构建配置

常见配置包括：Debug、Release、RelWithDebInfo 和 MinSizeRel。使用 -DCMAKE_BUILD_TYPE=Release 设置。

cmake -B build -DCMAKE_BUILD_TYPE=Release

编译器警告

将警告作为目标属性启用，以确保跨编译器的可移植性。

target_compile_options(myapp PRIVATE
    $<$<CXX_COMPILER_ID:GNU,Clang>:-Wall -Wextra>
    $<$<CXX_COMPILER_ID:MSVC>:/W4>
)

现代 CMake 风格

请优先使用基于目标的命令（target_*），而不是全局命令。这样可以将属性清晰地限定在特定目标的作用域内。

CMakePresets.json（CMake 3.19+）

在 CMakePresets.json 中定义可复用的配置，以便团队成员共享。

安装项目

使用 install 命令，将二进制文件、库和头文件复制到安装路径。

install(TARGETS myapp DESTINATION bin)
install(DIRECTORY include/ DESTINATION include)

快速检查

运行 CMake 时，推荐的目录模式是什么？

在交互式课程中回答

回顾

CMake 是标准的 C++ 构建系统生成器。请编写 CMakeLists.txt，在源代码树之外构建，并使用基于目标的命令。使用预设共享配置，并使用属性设置编译器标志。

免费开始

用 AI 导师学习 C++ — 免费

在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。

课程: 51
课程: 203

免费开始学习查看完整课程

常见问题解答

「CMake 项目布局与 CMakeLists.txt」课时是免费的吗？

是的 — 「CMake 项目布局与 CMakeLists.txt」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 C++ Academy 课程的其余内容，请升级到 CoddyKit PRO。 C++ Academy 课程共包含 4 节课。

「CMake 项目布局与 CMakeLists.txt」这节课中我会学到什么？

规划源代码树，并编写基础的 CMakeLists.txt 文件你通过在浏览器中直接运行的动手代码来练习 C++ Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 C++ Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 C++ Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「CMake 项目布局与 CMakeLists.txt」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 C++ Academy 课中编写并运行代码吗？

能。每节 C++ Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 C++ Academy