从Catch2 v2迁移至v3时出现undefined reference to `main'错误

你遇到的链接错误本质是程序找不到合法的main入口，结合Catch2 v3的特性，问题可能出在测试文件或CMake配置上，以下是具体排查和解决步骤：

测试文件层面排查 #

• Catch2 v3中，catch_all.hpp确实内置了main函数，但必须保证项目中只有一个测试文件包含该头文件：
  • 若多个文件都包含catch_all.hpp，会触发重复定义错误；若一个都没包含，就会出现当前找不到main的问题。
  • 如果你更习惯v2的写法，也可以在单个测试文件中先定义宏再包含头文件，这个方式在v3中依然有效：

    #define CATCH_CONFIG_MAIN
    #include <catch2/catch.hpp>
    

CMake配置层面排查 #

Catch2 v3的CMake集成方式和v2有较大差异，重点检查以下几点：

• 确保正确引入Catch2库：

  find_package(Catch2 3 REQUIRED)
  

• 链接库时选择正确的目标：
  • 若不想在代码中处理main函数，直接链接Catch2::Catch2WithMain（库内置了main）：

    target_link_libraries(你的测试可执行目标 PRIVATE Catch2::Catch2WithMain)
    

  • 若要自己通过宏或自定义代码提供main，则链接Catch2::Catch2：

    target_link_libraries(你的测试可执行目标 PRIVATE Catch2::Catch2)
    

• 确认测试目标是通过add_executable正确创建的，且所有测试源文件都被添加到该目标中。

版本兼容性检查 #

• 验证系统中安装的Catch2确实是v3版本，避免v2和v3混装导致头文件或库链接混乱。可以在CMake中强制指定版本，或者通过命令行确认：

  pkg-config --modversion catch2
  

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