Visual Studio中wxWidgets GUI窗口（Frame）无法打开的原因

项目代码 #

MainFrame.h（头文件） #

#pragma once
#include <wx/wx.h>

class MainFrame:public wxFrame
{
public:
    MainFrame(const wxString& title);
};

App.h（头文件） #

#pragma once
#include <wx/wx.h>

class App:public wxApp
{
public:
    bool onInit();
};

MainFrame.cpp #

#include <wx/wx.h>
#include "MainFrame.h"

using namespace std;

MainFrame::MainFrame(const wxString& title) :wxFrame(nullptr, wxID_ANY, title) {

}

App.cpp #

#include "App.h"
#include <wx/wx.h>
#include "MainFrame.h"

wxIMPLEMENT_APP(App);

bool App::onInit() {
    MainFrame* mainFrame = new MainFrame("main");
    mainFrame->Show();
    return true;
}

问题分析与解决 #

核心原因是方法名大小写错误：wxApp类的初始化虚函数是**OnInit()**（大写O开头），但你的代码里写成了小写开头的onInit()。这导致你并没有重写基类的虚函数，wxWidgets框架启动时不会调用你的窗口初始化逻辑，自然不会弹出GUI窗口。

修复步骤 #

1. 修改App.h中的声明：

   bool OnInit(); // 将onInit改为OnInit
   

2. 修改App.cpp中的实现：

   bool App::OnInit() { // 将onInit改为OnInit
       MainFrame* mainFrame = new MainFrame("main");
       mainFrame->Show();
       return true;
   }
   

额外排查点（若修复后仍有问题） #

• 确认项目配置与wxWidgets版本匹配：Visual Studio项目的Debug/Release模式要和wxWidgets编译的模式一致，同时检查包含目录、库目录、链接器输入是否正确配置。
• 显式指定显示参数：将mainFrame->Show();改为mainFrame->Show(true);，排除参数默认值的潜在问题。
• 检查wxIMPLEMENT_APP位置：确保它在App类实现的cpp文件中（你的代码位置正确）。

内容的提问来源于stack exchange，提问作者Богдан Иванилов