编译Catch2 V3基础测试代码时遭遇链接错误，求排查与解决方法

问题分析 #

从你提供的环境、代码和错误信息来看，这个链接错误的核心原因有两个：一是库的链接顺序不符合GNU链接器的解析规则，二是代码中宏定义的位置存在小问题。

先梳理你的场景细节：

环境与代码信息 #

• 平台：Linux WSL2 6.6.87.2-microsoft-standard-WSL2
• 编译器：g++ (Ubuntu 13.3.0-6ubuntu2~24.04) 13.3.0
• Catch2版本：3.4.0-1build1

你的测试代码：

#include <cstdint>
#include <catch2/catch_test_macros.hpp>

#define CATCH_CONFIG_MAIN

uint32_t factorial( uint32_t number ) {
    return number <= 1 ? number : factorial(number-1) * number;
}

TEST_CASE( "Factorials are computed", "[factorial]" ) {
    REQUIRE( factorial( 1) == 1 );
    REQUIRE( factorial( 2) == 2 );
    REQUIRE( factorial( 3) == 6 );
    REQUIRE( factorial(10) == 3'628'800 );
}

你使用的编译命令：

g++ tests/*.cpp -o tests.bin -lCatch2 -lCatch2Main

错误根源 #

GNU链接器是从左到右解析符号依赖的：当它处理libCatch2Main.a时，里面的默认main函数依赖于libCatch2中的Catch::Session等类的实现，但你把-lCatch2放在了-lCatch2Main前面——链接器处理完libCatch2后，会丢弃暂时用不到的符号，之后处理libCatch2Main遇到未定义符号时，就找不到之前libCatch2里的内容了，因此报出"undefined reference"错误。

另外，你的#define CATCH_CONFIG_MAIN放在了包含Catch2头文件之后，这个宏需要在头文件包含前定义才能被Catch2正确识别（不过这不是当前链接错误的直接原因，但会影响后续逻辑）。

解决步骤 #

方法一：调整链接库的顺序 #

把-lCatch2Main移到-lCatch2前面，让链接器先处理libCatch2Main的依赖，再从libCatch2中找到对应的实现：

修正后的编译命令：

g++ tests/*.cpp -o tests.bin -lCatch2Main -lCatch2

方法二：省略libCatch2Main，让Catch2生成主函数 #

如果你不想依赖外部的libCatch2Main库，可以通过CATCH_CONFIG_MAIN宏让Catch2在你的代码中生成main函数，这时候只需要链接-lCatch2即可：

1. 先修正宏定义的位置，移到头文件包含前：

#define CATCH_CONFIG_MAIN
#include <cstdint>
#include <catch2/catch_test_macros.hpp>

uint32_t factorial( uint32_t number ) {
    return number <= 1 ? number : factorial(number-1) * number;
}

TEST_CASE( "Factorials are computed", "[factorial]" ) {
    REQUIRE( factorial( 1) == 1 );
    REQUIRE( factorial( 2) == 2 );
    REQUIRE( factorial( 3) == 6 );
    REQUIRE( factorial(10) == 3'628'800 );
}

2. 编译命令简化为：

g++ tests/*.cpp -o tests.bin -lCatch2

验证结果 #

执行修正后的编译命令，成功生成tests.bin后，运行测试：

./tests.bin

会看到测试通过的输出：

===============================================================================
All tests passed (4 assertions in 1 test case)

内容来源于stack exchange