如何为C++ wxWidgets应用从零编写GUI测试套件

你触发段错误的核心原因是运行GUI测试时没有初始化wxWidgets应用实例与事件循环，wxTheApp指针为空，且不存在可用的顶层窗口作为父组件，调用wxTheApp->GetTopWindow()自然触发内存访问错误。
以下是从零搭建wxWidgets GUI测试套件的完整方案：

1. 自定义测试入口初始化wxWidgets运行环境 #

替换Catch默认的主函数，在测试运行前初始化wxApp实例、创建隐藏的顶层窗口作为所有测试组件的父容器，测试结束后统一销毁资源。

#define CATCH_CONFIG_RUNNER
#include "catch.hpp"
#include "wx/wx.h"
#include "wx/app.h"

// 自定义测试用的wxApp类
class TestApp : public wxApp {
public:
    bool OnInit() override {
        if (!wxApp::OnInit()) return false;
        // 创建隐藏的顶层窗口，作为所有测试控件的父容器
        m_topWindow = new wxFrame(nullptr, wxID_ANY, "Test Window");
        return true;
    }

    int OnExit() override {
        m_topWindow->Destroy();
        return wxApp::OnExit();
    }

    wxFrame* m_topWindow = nullptr;
};

wxDECLARE_APP(TestApp);
wxIMPLEMENT_APP_NO_MAIN(TestApp);

int main(int argc, char* argv[]) {
    // 初始化wxWidgets运行环境
    wxEntryStart(argc, argv);
    auto& app = wxGetApp();
    if (!app.CallOnInit()) {
        return 1;
    }

    // 运行Catch测试套件
    int testResult = Catch::Session().run(argc, argv);

    // 清理wxWidgets资源
    app.OnExit();
    wxEntryCleanup();

    return testResult;
}

2. 调整GUI测试用例写法 #

测试组件时直接使用提前初始化好的全局顶层窗口作为父组件，测试完成后正确销毁临时组件。

#include "catch.hpp"
#include "wx/wx.h"

extern TestApp& wxGetApp();

TEST_CASE("wxButton basic creation", "[gui][wxButton]") {
    // 用提前创建好的隐藏顶层窗口作为父组件
    wxButton* button = new wxButton(wxGetApp().m_topWindow, wxID_ANY, "wxButton");
    // 触发事件循环处理待执行的初始化事件
    wxYield();
    // 自定义断言逻辑
    REQUIRE(button->GetLabel() == "wxButton");
    // 测试完成后销毁临时组件，避免内存泄漏
    button->Destroy();
    wxYield();
}

3. 调整CMake配置（Windows平台可选） #

Windows平台下可指定测试程序为GUI程序，避免运行时弹出控制台窗口影响测试：

if(WIN32)
    set_target_properties(tests PROPERTIES WIN32_EXECUTABLE YES)
endif()

注意事项 #

• 所有GUI组件的创建、操作、销毁都必须在wxWidgets初始化完成后、清理前执行，禁止在wxEntryStart执行前操作任何GUI类
• 不要直接delete wxGUI组件，调用Destroy()方法交由wxWidgets的事件循环处理销毁逻辑，避免野指针问题
• 如需模拟用户点击、输入等交互，可以直接使用wxWidgets内置的wxUIActionSimulator类实现
• 测试用的顶层窗口不需要显示，保持默认隐藏状态即可正常执行所有GUI逻辑测试

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