需正确设置入口点并链接对应库：继承wxApp实现OnInit()，末尾加IMPLEMENT_APP；Linux链接wx_gtk3u在wx_baseu后，macOS启用Cocoa支持，Windows避免混用编译器。
wxWidgets 编译和链接时总报 undefined reference to `wxAppConsole::OnInit() 怎么办
这是新手最常卡住的第一步：没正确设置入口点，或链接了错误的库。wxWidgets 不是直接调用 main()，它需要你继承 wxApp 并重写 OnInit()，同时编译器得知道从 wxEntry()（而非默认 main）开始执行。
- 确保你的主类继承自
wxApp，且实现了OnInit()（返回true），并在文件末尾加上IMPLEMENT_APP(YourAppClass) - 链接时必须包含
wx_baseu（Unicode 版）或wx_base（ANSI 版），以及 GUI 相关库如wx_gtk3u（Linux）、wx_osx_cocoau（macOS）、wx_mswu（Windows）——不能只链wx_baseu - Linux 下用 pkg-config 时，别漏掉
$(pkg-config --libs --cflags wxgtk3-3.2)；手动写链接顺序很重要：wx_gtk3u必须在wx_baseu之后 - Windows 上若用 MinGW，确认没有混用 MSVC 编译的 wxWidgets 库；路径中含空格或中文会导致链接静默失败
创建窗口后点击关闭就崩溃，OnClose() 和 OnExit() 到底该在哪写
崩溃通常是因为没处理好对象生命周期：wxWidgets 默认会自动销毁顶层窗口，但如果你在 OnClose() 里手动 delete this 或重复调用 Destroy()，就会 double-delete。
-
OnClose()是响应wxCloseEvent的地方，适合做保存、确认退出等逻辑；调用event.Skip()让框架继续处理销毁流程 - 不要在
OnClose()里调用Destroy()或Close(true)—— 框架已为你做了；除非你明确想拦截关闭（比如弹确认框），此时应调用event.Veto() -
OnExit()是wxApp的虚函数，在整个应用退出前调用，适合清理全局资源（如日志文件句柄、线程池），不是窗口级逻辑的落点 - 所有通过
new wxFrame(...)创建的窗口，只要没设wxWANTS_CHARS等特殊 flag，都由 wxWidgets 自动管理内存，无需手动 delete
在 macOS 上编译能过，运行时报 NSInternalInconsistencyException 或黑窗口
这是 Cocoa 线程模型导致的：macOS 要求所有 UI 操作必须在主线程（即 AppKit 的 main thread）执行，而 wxWidgets 默认可能把事件分发到其他线程，或初始化时机不对。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 确保
IMPLEMENT_APP()宏后的类名与实际定义的类名完全一致（大小写敏感），否则 macOS 启动时找不到有效 app 实例 - 不要在非主线程调用
wxFrame::Show()、wxWindow::Refresh()等 UI 方法；跨线程更新界面请用wxCallAfter()或wxPostEvent() - CMake 中启用 Cocoa 支持需显式加
-DWX_BUILD_OSX_COCOA=ON，且构建类型必须是Application（不是 Bundle 或 Framework） - 如果用了
wxThread，切记 macOS 上禁止在子线程创建或操作任何wxWindow子类对象
布局写完不生效，wxBoxSizer 里控件挤成一团或根本看不见
根本原因通常是忘了调用 SetSizer() 或 Layout()，或者 sizer 没被父容器“认领”。
立即学习“C++免费学习笔记（深入）”；
- 对
wxFrame，必须在创建完 sizer 后调用frame->SetSizer(sizer)；对wxPanel或其他容器，还需额外调用sizer->SetSizeHints(this)（尤其在非 frame 场景下） - 添加控件到 sizer 时，第三个参数（proportion）为 0 表示不拉伸，1+ 才参与分配剩余空间；但若所有控件 proportion 都是 0，那它们就按最小尺寸堆在一起
- 修改 sizer 内容后（比如动态增删控件），必须手动调用
Layout()，否则界面不会重排；Refresh()不管用 - 调试技巧：临时给 sizer 设置背景色（
sizer->SetBackgroundColour(*wxRED)）看它是否占满父窗口，能快速定位是否 set-sizer 失败
