Windows系统下VSCode中Google Test/GMock使用方法及collect2.exe链接错误解决方案

一、先搞定那个烦人的collect2链接错误 #

collect2.exe: ld returned 1 exit status本质就是链接器找不到需要的库文件，或者编译环境不匹配，给你几个精准排查方向：

• 检查库路径与链接参数是否匹配
  你之前按指南操作时，大概率是tasks.json里没正确指定GTest/GMock的库路径和链接库。比如用MinGW的话，要在args里加-L"你的GTest编译后lib文件夹路径"，还要加上-lgtest -lgtest_main -lgmock -lgmock_main（如果是MSVC的话，参数是/LIBPATH:路径 gtest.lib gtest_main.lib这种格式）。

• 编译器必须统一！
  你说Visual Studio里能跑，VSCode里不行，十有八九是两边用的编译器不一样——VS用的是MSVC，VSCode里可能用了MinGW。不同编译器编译出来的库根本不兼容，一定要统一：要么全用MSVC，要么全用MinGW。比如选MinGW的话，就得用MinGW的g++重新编译GTest/GMock，别用VS编译的库。

• 确认编译时包含了所有必要文件
  要是你只编译了测试文件，没把要测试的源文件加进去，或者反过来，链接的时候缺少对象文件也会报这个错。比如在tasks.json的args里，要把calc.cpp（你的业务代码）和calc_test.cpp（测试代码）都列进去，或者用${fileDirname}\\*.cpp来匹配所有cpp文件（前提是它们都在同一个目录）。

• 动态库要加宏定义
  如果你编译的是GTest动态库，那测试代码开头必须加#define GTEST_LINKED_AS_SHARED_LIBRARY，不然链接会出问题，还要记得把生成的DLL文件放到可执行文件同目录下。

二、Windows下VSCode用GTest/GMock测试C++的完整步骤 #

1. 先编译出适配你编译器的GTest/GMock库 #

这里以MinGW为例（MSVC步骤类似，只是编译命令不同）：

• 克隆源码：git clone https://github.com/google/googletest.git
• 进入源码目录，建个build文件夹：cd googletest && mkdir build && cd build
• 用CMake生成MinGW编译文件：cmake .. -G "MinGW Makefiles"
• 编译库：mingw32-make，完成后build/lib里会有libgtest.a、libgtest_main.a这些静态库，头文件在googletest/googletest/include和googletest/googlemock/include。

2. 配置VSCode的编译任务（tasks.json） #

按Ctrl+Shift+B，选择创建tasks.json，选C/C++: g++.exe 生成活动文件，然后改成下面的内容（记得替换成你自己的路径）：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++.exe 生成测试程序",
            "command": "C:\\MinGW\\bin\\g++.exe", // 你的g++路径
            "args": [
                "-g",
                "${fileDirname}\\*.cpp",
                "-I", "C:\\你的路径\\googletest\\googletest\\include", // GTest头文件路径
                "-I", "C:\\你的路径\\googletest\\googlemock\\include", // GMock头文件路径
                "-L", "C:\\你的路径\\googletest\\build\\lib", // 库文件路径
                "-lgtest",
                "-lgtest_main",
                "-lgmock",
                "-lgmock_main",
                "-o", "${fileDirname}\\test.exe"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": ["$gcc"],
            "group": {"kind": "build", "isDefault": true},
            "detail": "编译器: C:\\MinGW\\bin\\g++.exe"
        }
    ]
}

如果用MSVC，把command改成cl.exe，args换成MSVC的参数格式，比如用/I指定头文件，/link指定库路径和库名。

3. 配置调试（可选，launch.json） #

按F5创建launch.json，选C++(GDB/LLDB)，修改成这样：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "g++.exe - 生成和调试活动文件",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}\\test.exe",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "miDebuggerPath": "C:\\MinGW\\bin\\gdb.exe",
            "setupCommands": [
                {
                    "description": "为 gdb 启用整齐打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "C/C++: g++.exe 生成测试程序" // 和tasks里的label一致
        }
    ]
}

4. 写测试代码示例 #

比如你的业务代码calc.cpp：

int add(int a, int b) {
    return a + b;
}

测试文件calc_test.cpp：

#include <gtest/gtest.h>
#include <gmock/gmock.h>
#include "calc.cpp"

TEST(CalcTest, AddPositiveNumbers) {
    EXPECT_EQ(add(1, 2), 3);
    ASSERT_EQ(add(5, 5), 10);
}

// GMock示例：模拟一个打印类
class MockPrinter {
public:
    MOCK_METHOD(void, PrintMessage, (const std::string&), ());
};

TEST(MockPrinterTest, VerifyPrintCall) {
    MockPrinter printer;
    EXPECT_CALL(printer, PrintMessage("Hello GMock!"));
    printer.PrintMessage("Hello GMock!");
}

不用自己写main函数，gtest_main已经帮你实现了入口。

5. 运行测试 #

按Ctrl+Shift+B编译生成test.exe，然后在终端里输入.\test.exe就能看到测试结果了。如果配置了调试，按F5就能单步调试测试用例。

三、几个避坑提醒 #

• 编译器一定要统一！别一边用MSVC编译GTest，一边在VSCode里用MinGW编译代码，绝对会出问题。
• 推荐用静态库，不用折腾DLL文件，新手友好。
• 头文件尽量用-I参数指定路径，别复制到项目里，避免版本冲突。

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