使用 CMake 自动管理 C/C++ 项目

ops/2025/2/8 12:02:10/

使用 CMake 自动管理 C/C++ 项目

1. 介绍

CMake 是一个强大的构建系统，可用于跨平台管理 C/C++ 项目的编译过程。本 CMakeLists.txt 文件提供了一种自动化的方式来管理 C/C++ 项目，包括创建代码目录、自动编译所有源文件、管理输出文件等。

2. CMake 最低版本要求 & 项目信息

cmake">cmake_minimum_required(VERSION 3.14)
project(TestDemo C CXX)

这段代码确保 CMake 版本不低于 3.14，并定义项目名称 TestDemo，支持 C 和 C++ 语言。

3. 主要功能

该 CMakeLists.txt 具备以下功能：

  • 自动创建 src 目录，存放源代码文件；
  • 自动遍历 src 目录，编译其中的所有 .c 和 .cpp 文件；
  • 设定编译输出路径，避免污染项目根目录：
    • .runtime/ 目录存放可执行文件；
    • .library/ 目录存放静态/动态库；
    • .archive/ 目录存放编译中间文件；
  • 支持多个 main() 函数，可以直接运行单个源文件。

4. C/C++ 语言标准设定

cmake">set(CMAKE_C_STANDARD 99)
set(CMAKE_CXX_STANDARD 17)

此处指定 C 语言标准为 C99，C++ 语言标准为 C++17。

5. 编译输出目录设定

cmake">set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${PROJECT_SOURCE_DIR}/.archive)
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${PROJECT_SOURCE_DIR}/.library)
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${PROJECT_SOURCE_DIR}/.runtime)
set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/.runtime)
set(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/.library)

这些配置确保编译后的文件不会污染项目根目录。

6. 自动创建 src 目录

cmake">set(SRC_DIR ${PROJECT_SOURCE_DIR}/src)
if (NOT EXISTS ${SRC_DIR})file(MAKE_DIRECTORY ${SRC_DIR})
endif ()
message(STATUS "src目录: ${SRC_DIR}")

若 src 目录不存在，则自动创建，并在 CMake 输出日志中打印 src 目录路径。

7. 头文件搜索路径

cmake">include_directories(${SRC_DIR})

这行代码告诉编译器在 src 目录中查找头文件。

8. 自动遍历 src 目录下的 C/C++ 文件

cmake">file(GLOB_RECURSE SOURCE_FILES "${SRC_DIR}/*.c" "${SRC_DIR}/*.cpp")

使用 file(GLOB_RECURSE ...) 指令递归查找 src 目录下的所有 .c 和 .cpp 文件。

9. 生成唯一目标名并添加可执行文件

cmake">foreach (SOURCE_FILE ${SOURCE_FILES})get_filename_component(FILE_NAME ${SOURCE_FILE} NAME)string(REGEX REPLACE "^${SRC_DIR}[\\/]" "" RELATIVE_PATH ${SOURCE_FILE})string(REGEX REPLACE "[\\/]" "." TARGET_NAME ${RELATIVE_PATH})add_executable(${TARGET_NAME} ${SOURCE_FILE})message(STATUS "[Compile] ${SOURCE_FILE} --> ${TARGET_NAME}")
endforeach ()
  • 获取文件名：
    cmake">get_filename_component(FILE_NAME ${SOURCE_FILE} NAME)
  • 计算相对路径（去掉 src/ 部分），并将 / 替换为 .，仿照 Java 包命名格式。
  • 添加可执行文件，确保每个 C/C++ 文件都能独立编译。

10. 编译警告设置

cmake">if (MSVC)add_compile_options(/W4)
else ()add_compile_options(-Wall -Wextra -Wpedantic)
endif ()
  • Windows（MSVC）：开启最高级别 /W4 警告。
  • Linux/macOS（GCC/Clang）：启用 -Wall -Wextra -Wpedantic，增强代码质量。

11. CMake 关键指令说明

11.1 获取文件名组件

cmake">get_filename_component(变量名 文件路径 组件类型)

示例：

cmake">get_filename_component(FILE_NAME "D:/test/hello.txt" NAME_WE)

11.2 递归扫描目录下的 C/C++ 文件

cmake">file(GLOB_RECURSE 变量名 "路径/*.c" "路径/*.cpp")

示例：

cmake">file(GLOB_RECURSE SOURCE_FILES "src/*.c" "src/*.cpp")

11.3 正则替换字符串

cmake">string(REGEX REPLACE "正则表达式" "替换字符串" 变量 输入变量)

示例：

cmake">string(REGEX REPLACE "\\/" "." TARGET_NAME "src/com/example/Main.cpp")

11.4 数学运算

cmake">math(EXPR 变量 "数学表达式")

示例：

cmake">math(EXPR RESULT "5 * 5")

11.5 编译可执行文件

cmake">add_executable(可执行文件 源文件)

示例：

cmake">add_executable(my_program main.cpp)

11.6 目标链接库

cmake">target_link_libraries(可执行文件 PRIVATE 库名1 库名2)

示例：

cmake">target_link_libraries(my_program PRIVATE jsoncpp_lib jsoncpp_object)

11.7 日志输出

cmake">message(STATUS "日志信息")

示例：

cmake">message(STATUS "编译目录: ${CMAKE_RUNTIME_OUTPUT_DIRECTORY}")

12. 结论

这个 CMakeLists.txt 通过自动化管理 C/C++ 源文件、输出目录和编译过程，使项目更加结构化。它可以让开发者专注于编写代码，而无需手动管理每个可执行文件的构建。

13. 我常用的CMakeLists.txt配置

cmake"># 设置 CMake 最小版本 & 项目名称, 编程语言C、C++
cmake_minimum_required(VERSION 3.14)
project(TestDemo C CXX)# >------------------------------- CMake 功能说明 -------------------------------
# 本 CMakeLists.txt 具备以下功能：
# 1. 重新加载 CMake 项目时，自动创建 src 目录（存放代码文件）。
# 2. 自动遍历 src 目录下的所有 .c 和 .cpp 文件，并生成独立的可执行文件。
# 3. 设定编译输出路径，避免污染项目根目录：
#    - 可执行文件存放于 `.runtime/` 目录。(即编译结果)
#    - 静态/动态库存放于 `.library/` 目录。
#    - 编译时中间文件存放于 `.archive/` 目录。
# 4. 允许多个 main() 函数共存，可直接运行单个文件。
# >------------------------------- 使用说明 -------------------------------
# 使用此CMakeList时，若要新建C/C++语言文件，请按照以下步骤：
# 1. 右键src目录(如果没有src目录，请先创建) ——> 新建 ——> C/C++源文件
# 2. 在弹出的对话框中，输入文件名(仅允许英文小写及下划线，不要出现空格)，
#    后缀为 ".c(C语言文件)"或".cpp(C++文件)"，切记不要勾选“添加到目标”，点击确定。
# 3. 点击 左上角横线 ——> 文件 ——> 重新加载CMake项目。
# 注：未重载前，进入文件可能会有“不属于任何项目目标”的警告，重载后即会消失。
#    若此警告未消失，请检查文件是否在src目录下，以及文件名是否符合规范。
# >------------------------------- 运行说明 -------------------------------
# 使用此CMakeList时，若运行 main() 函数代码，请直接点击函数前的绿色三角形按钮。
# 右上角的运行按钮会自动运行最近一次运行的程序，因此可能不是你想要的结果。
# >------------------------------- 注意事项 -------------------------------
# 可执行文件名，模仿Java包名 + 文件名 格式
# 例如：
#      文件路径 src/com/example/testdemo/Main.cpp
#      可执行文件名 com.example.testdemo.Main.cpp
# ------------------------------------------------------------------------# 按照书本要求设定C语言和C++版本
set(CMAKE_C_STANDARD 99)
set(CMAKE_CXX_STANDARD 17)# 定义输出目录，避免污染根目录
set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${PROJECT_SOURCE_DIR}/.archive)
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${PROJECT_SOURCE_DIR}/.library)
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${PROJECT_SOURCE_DIR}/.runtime)
set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/.runtime)
set(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/.library)# 自动创建存放代码文件夹 src (重新加载CMake项目后，会自动创建)
set(SRC_DIR ${PROJECT_SOURCE_DIR}/src)
if (NOT EXISTS ${SRC_DIR})file(MAKE_DIRECTORY ${SRC_DIR})
endif ()
message(STATUS "src目录: ${SRC_DIR}")# 设定头文件搜索路径
include_directories(${SRC_DIR})# 遍历 src 目录下所有 C/C++ 文件并自动添加
file(GLOB_RECURSE SOURCE_FILES "${SRC_DIR}/*.c" "${SRC_DIR}/*.cpp")foreach (SOURCE_FILE ${SOURCE_FILES}) # 遍历所有发现的文件# 生成唯一的目标名（避免重名问题）# get_filename_component(FILE_NAME ${SOURCE_FILE} NAME_WE) # 获取文件名（去掉扩展名）【注意: 这样子 C、C++ 文件在同一个目录, 并且文件名相同时，会导致冲突】get_filename_component(FILE_NAME ${SOURCE_FILE} NAME) # 获取文件名# 计算相对路径（去掉 src/ 部分），并且将`/`替换成`.` 模仿成Java的包名，方便后续添加到编译命令中string(REGEX REPLACE "^${SRC_DIR}[\\/]" "" RELATIVE_PATH ${SOURCE_FILE})string(REGEX REPLACE "[\\/]" "." TARGET_NAME ${RELATIVE_PATH})  # 将`/`替换成`.` 模仿成Java的包名，避免重名问题# 添加可执行文件add_executable(${TARGET_NAME} ${SOURCE_FILE})message(STATUS "[Compile] ${SOURCE_FILE} --> ${TARGET_NAME}")
endforeach () # 遍历结束# -------------------------- CMake 关键指令说明 --------------------------
# 1. 获取文件名组件:
#    get_filename_component(变量名 文件路径 组件类型)
#    例如: 获取文件名（无扩展名）
#    get_filename_component(FILE_NAME "D:/test/hello.txt" NAME_WE)
#
# 2. 递归扫描指定目录下的所有 C/C++ 文件:
#    file(GLOB_RECURSE 保存结果的变量名 "路径/*.c" "路径/*.cpp")
#    例如: 扫描 src 目录下的所有 C 和 C++ 文件
#    file(GLOB_RECURSE SOURCE_FILES "D:/test1/*.c" "D:/test2/*.cpp")
#
# 3. 字符串处理:
#    - 正则表达式替换:
#      string(REGEX REPLACE "正则表达式" "替换字符串" 存储结果变量 输入变量)
#      例如: 将路径中的 "/" 替换为 "."
#      string(REGEX REPLACE "/" "." TARGET_NAME "D:/test/hello.txt")
#
#    - 计算字符串长度:
#      string(LENGTH 字符串变量 存储结果变量)
#
#    - 字符串截取:
#      string(SUBSTRING 字符串变量 起始下标 截取元素个数 存储结果变量)
#      例如: 截取字符串的前 5 个字符
#      string(SUBSTRING "hello world" 0 5 SUB_STR)
#
# 4. 数学运算:
#    math(EXPR 存储结果变量 "数学表达式")
#    例如: 计算一个数值的平方
#    math(EXPR RESULT "5 * 5")
#
# 5. 编译可执行文件:
#    add_executable(可执行文件名称 源码文件)
#    例如: 生成一个名为 my_program 的可执行文件
#    add_executable(my_program main.cpp)
#
# 6. 目标链接库:
#    target_link_libraries(可执行文件名称 PRIVATE 库名1 库名2)
#    例如: 连接 jsoncpp 库
#    target_link_libraries(my_program PRIVATE jsoncpp_lib jsoncpp_object)
#
# 7. 日志输出:
#    message(STATUS "日志信息")
#    例如: 输出 CMake 变量值
#    message(STATUS "编译目录: ${OUTPUT_DIR_RUNTIME}")
# ----------------------------------------------------------------------# *********************************************************************************# 设置编译选项（开启警告）
if (MSVC)add_compile_options(/W4)
else ()add_compile_options(-Wall -Wextra -Wpedantic)
endif ()

效果图
在这里插入图片描述


http://www.ppmy.cn/ops/156720.html

相关文章

如何在Linux上安装Ollama

如何在Linux上安装Ollama

安装Ollama 安装Ollama的步骤相对简单，以下是基本的安装指南： 访问官方网站：打开浏览器，访问Ollama的官方网站。 下载安装包：根据你的操作系统，选择相应的安装包进行下载。 运行安装程序：下载完…
阅读更多...
Windows Docker笔记-制作、加载镜像

Windows Docker笔记-制作、加载镜像

引言 在文章《Windows Docker笔记-在容器中运行项目》中，已经在容器中运行了项目。而且在这个容器中，已经调试好了项目运行的环境。 使用docker，就是为了在项目发布到生产环境时，不用再去安装项目运行的环境，直接丢给…
阅读更多...
深度分析：网站快速收录与网站内容多样性的关系

深度分析：网站快速收录与网站内容多样性的关系

本文转自：百万收录网 原文链接：https://www.baiwanshoulu.com/87.html 网站快速收录与网站内容多样性之间存在着密切的关系。以下是对这一关系的深度分析： 一、网站内容多样性对快速收录的影响 提升搜索引擎抓取效率： 多样化的…
阅读更多...
【STM32】AHT20温湿度模块

【STM32】AHT20温湿度模块

AHT20温度模块采用的是I2C硬件通信协议。本篇文章会根据时序图实现AHT20模块初始化，以及读取温湿度 AHT20温度模块对应电路图 得到设备地址，读地址的话设备地址为0x71,写的话为0x70 1.根据手册写aht20初始化代码 void aht20_init() { uint8_t rea…
阅读更多...
WebSocket——netty实现websocket编码

WebSocket——netty实现websocket编码

一、前言：WebSocket 和 Netty 简介 在现代的互联网应用中，许多场景需要实时通信，比如在线聊天、实时通知、股票行情更新等。这些场景下，我们需要一种技术，让服务器能够主动向客户端推送消息。WebSocket 就是为了解决这…
阅读更多...
支持向量机（一）

支持向量机（一）

支持向量机是典型的二分类模型，以其模型简单、实现简单、效果卓越而著称。 一元支持向量机 我们通过一条中间线根据特征对样本实现分类，很明显：两个支持样本的差别越大，两个支持样本的分类效果就越好。 二元支持向量机 在实际生…
阅读更多...
QT实现多线程的方法

QT实现多线程的方法

目录 一、继承QThread类 1）自定义线程类 2）使用自定义的子线程类 3）使用说明 二、利用QThread的消息循环 1）自定义执行类 2）启动子线程 3）方法说明 三、使用线程池 四、方法比较 QT多线程编程常…
阅读更多...
《DeepSeek R1:7b 写一个python程序调用摄像头获取视频并显示》

《DeepSeek R1:7b 写一个python程序调用摄像头获取视频并显示》

C:\Users\Administrator>ollama run deepseek-r1:7b hello Hello! How can I assist you today? 😊 写一个python程序调用摄像头获取视频并显示 好，我需要帮用户写一个Python程序，它能够使用摄像头获取视频，并在屏幕上显示出…
阅读更多...
最新文章

Copyright @ 2022~2023