如何在CMake中正确引入本地Catch2 v3.4.0？

错误原因 #

你直接将Catch2源码放在目录中，但CMake的find_package查找的是构建或安装后生成的配置文件（Catch2Config.cmake等），源码目录本身并不包含这些文件，所以直接设置Catch2_DIR到源码目录无效。

两种可行解决方案 #

方案1：直接引入Catch2源码（无需安装） #

修改测试项目的CMakeLists.txt，用add_subdirectory直接引入Catch2源码目录，CMake会自动构建Catch2并生成可链接的目标：

# 引入Catch2源码，指定二进制输出目录避免污染源码树
add_subdirectory(d:/Libraries/Catch2-3.4.0 ${CMAKE_BINARY_DIR}/catch2_build)
add_executable(test_project main.cpp)
target_link_libraries(test_project PRIVATE Catch2::Catch2WithMain)

这种方式不需要提前构建或安装Catch2，适合快速集成。

方案2：先构建并安装Catch2，再使用find_package #

如果坚持用find_package，需要先完成Catch2的构建与安装：

1. 为Catch2创建单独的构建目录，比如d:/Libraries/Catch2-3.4.0/build
2. 进入该构建目录，运行CMake配置命令（指定安装路径）：

cmake .. -DCMAKE_INSTALL_PREFIX=d:/Libraries/Catch2-3.4.0/install

3. 执行安装命令：

cmake --build . --target install

4. 安装完成后，在d:/Libraries/Catch2-3.4.0/install/lib/cmake/Catch2目录下会生成所需的配置文件。此时在测试项目中，将Catch2_DIR设置为该路径，或者把d:/Libraries/Catch2-3.4.0/install添加到CMAKE_PREFIX_PATH，再运行find_package(Catch2 3 REQUIRED)即可正常找到。

注意：Catch2_DIR必须指向包含Catch2Config.cmake的目录，即安装后的lib/cmake/Catch2，而非源码目录或源码中的CMake子目录。

内容的提问来源于stack exchange，提问作者Marius Bancila