基于CMake构建C++应用时集成Catch2测试后出现未定义引用构建错误

这类undefined reference报错属于典型的链接阶段缺失Catch2库实现的问题。当前构建流程仅能让编译器找到catch.hpp头文件、完成main.cpp的目标文件编译，但完全没有将Catch2的功能实现代码链接到最终的可执行文件中，导致链接器找不到Catch::StringRef、Catch::AssertionHandler这些测试框架类的具体实现地址。

• 确认编译阶段的头文件路径配置：如果报错是在链接阶段抛出（生成obj成功、卡在最后链接可执行文件的环节），说明头文件路径配置正常，问题完全出在链接环节
• 检查CMake配置的链接逻辑：当前给出的CMakeLists.txt仅声明了可执行文件的源文件，没有任何针对Catch2的链接规则，必然会触发链接错误
• 确认本地Catch2的分发形式：是通过包管理器安装的独立库版本，还是直接拷贝到项目目录的单头文件版本，两种场景的解决逻辑完全不同

根据使用Catch2的不同场景，对应修改配置即可：

场景1：使用系统/包管理器安装的Catch2库 #

vcpkg、apt、本地编译安装的Catch2会导出标准的CMake目标，直接修改CMakeLists.txt即可：

cmake_minimum_required(VERSION 3.20.2)
project(intent_recognition)

# 查找本地安装的Catch2依赖
find_package(Catch2 REQUIRED)

add_executable(intent_recognition main.cpp)
# 链接Catch2的完整实现（包含内置main入口）
target_link_libraries(intent_recognition PRIVATE Catch2::Catch2WithMain)

注意：链接Catch2::Catch2WithMain后，需要删掉main.cpp里的#define CONFIG_CATCH_MAIN，避免重复定义main函数触发新的链接错误。

场景2：使用项目内拷贝的单头文件版本Catch2 #

Catch2 v2及以上的单头文件版本，不会在头文件被引入时自动展开全部实现，必须在全局唯一的一个cpp文件里定义对应版本的主函数宏，才能让编译器生成对应的实现代码。操作步骤为：

1. 新增独立的catch_main.cpp文件，内容仅为：

   #define CONFIG_CATCH_MAIN
   #include "catch.hpp"
   

2. 修改CMakeLists.txt，将该文件加入可执行文件的源文件列表：

   cmake_minimum_required(VERSION 3.20.2)
   project(intent_recognition)
   # 把Catch2的实现源文件加入编译列表
   add_executable(intent_recognition main.cpp catch_main.cpp)
   

注意：主函数宏全局只能在一个源文件里定义，不能在main.cpp和catch_main.cpp里同时定义，否则会出现main函数重复定义的报错。

内容的提问来源于stack exchange，提问作者fel1-xd