刚学 Win32 的人,大概率会先后遇到两个看起来相反的问题。
第一个:照着教程写了 CreateWindowExW,编译运行,窗口闪一下就没了,进程也退出了。第二个:加上了消息循环,窗口能正常显示,但点右上角的关闭按钮没反应,或者窗口消失了,任务管理器里进程还赖着不走。
这两个现象都指向同一件事:桌面程序的生死不由 main 的函数体决定,而由消息循环决定。窗口只是屏幕上的一块区域,真正让程序持续响应的是那个不断从队列里取消息的循环。这篇就把这条线拆开,顺便解释为什么点了按钮之后界面会白屏、假死。
先看窗口的一生
一个典型的 Win32 窗口,从创建到销毁要经过下面这些步骤。每一步都能对应到代码里的一行或一个消息:
注意最后两步的顺序。销毁窗口和退出程序不是一回事:窗口可以销毁了但进程继续在后台跑(托盘程序就是这样),也可以有多个窗口,关掉一个不影响其他窗口。真正让循环停下来的是 WM_QUIT,它由 PostQuitMessage 放进线程的消息队列。
还有个容易被忽略的细节:消息队列不是程序一启动就有的,线程第一次创建窗口时,系统才给它建队列。所以纯控制台程序调用 GetMessageW 会一直等不到消息,也不会有窗口相关的行为。反过来,只要线程创建过窗口,它就有了自己的队列,之后所有窗口消息都进这个队列,按到达顺序排队。
消息循环到底在循环什么
每个创建窗口的线程都有自己的消息队列,这个线程叫 UI 线程。用户按键、移动鼠标、点按钮、窗口需要重绘、定时器到点,系统都会把对应的事件包装成消息,放进这个队列。消息循环的工作就是不断地取出来、翻译、分发:
MSG msg{};
while (GetMessageW(&msg, nullptr, 0, 0) > 0) {
TranslateMessage(&msg);
DispatchMessageW(&msg);
}
三行代码,三个关键点。
GetMessageW 是阻塞的。队列里没消息时,线程就挂起,不占 CPU;有消息才返回。这一点很重要——消息循环不是死循环忙等,所以一个空闲的桌面程序 CPU 占用接近零。新手写成 while (PeekMessageW(...)) 而不做等待,才会把 CPU 跑到 100%。
TranslateMessage 处理键盘消息,把 WM_KEYDOWN 这种「哪个键按下了」翻译成 WM_CHAR 这种「输入了什么字符」。不做这一步,很多输入框行为会不正常。
DispatchMessageW 把消息交给窗口过程函数,也就是你写的 WndProc。窗口过程里 switch 处理关心的消息,不关心的交给 DefWindowProcW,由系统做默认处理。
PostMessage 把消息放进队列,等当前代码执行完才处理;SendMessage 直接调用目标窗口的窗口过程,调用方会一直阻塞到处理完。跨线程用 SendMessage 要格外小心,两边互相等待就是死锁。PostMessage:放进队列
调用立刻返回,消息排在该线程队列的末尾。适合「通知界面更新」「自定义进度消息」这类不需要立刻拿到结果的场景。缺点是消息可能被其他消息插队,时机不可精确控制;队列积压时,界面会滞后。
SendMessage:直接调用
目标窗口的窗口过程同步执行,返回时结果已经产生。适合「取控件文字」「设置属性」这类需要立即结果的场景。缺点是调用方会被阻塞;如果两个线程互相 SendMessage,两边都在等对方处理,就是死锁。
一条经验:同一线程内、需要返回值时用 SendMessage;跨线程、只是通知时用 PostMessage。拿不准就用后者,它不会把调用方卡住。
GetMessageW 的返回值有三种情况,循环条件写成 > 0 是有讲究的:大于零表示取到一条消息;返回 0 表示收到 WM_QUIT,属于正常退出;返回 -1 表示出错,通常是窗口句柄无效。写成 while (GetMessageW(...)) 而不判符号,出错时 -1 会被当成真,循环继续转,表现就是退不出去或者空转。这种写法在老代码里很常见,平时不出问题,只在异常路径上炸。
队列也有归属。消息队列属于线程,不属于窗口;线程第一次调用用户或 GDI 相关函数时,系统才给它挂上队列。所以两个线程各自创建的窗口,消息分别进各自的队列,窗口过程也在各自的线程里执行。跨线程 SendMessage 时,系统把消息投到目标线程的队列,再等它处理完,这就是死锁的物理来源。
一次完整的实测走查
下面这个程序会创建窗口、画一行字,1.5 秒后给自己发一个 WM_CLOSE,并在每个关键消息到达时打日志。代码完整可编译:
#define UNICODE
#define _UNICODE
#include <windows.h>
#include <cstdio>
LRESULT CALLBACK WndProc(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam) {
switch (msg) {
case WM_PAINT: {
PAINTSTRUCT ps{};
HDC dc = BeginPaint(hwnd, &ps);
TextOutW(dc, 24, 24, L"hello desktop", 13);
EndPaint(hwnd, &ps);
std::printf("[msg] WM_PAINT\n");
return 0;
}
case WM_TIMER:
std::printf("[msg] WM_TIMER\n");
PostMessageW(hwnd, WM_CLOSE, 0, 0);
return 0;
case WM_CLOSE:
std::printf("[msg] WM_CLOSE\n");
DestroyWindow(hwnd);
return 0;
case WM_DESTROY:
std::printf("[msg] WM_DESTROY\n");
PostQuitMessage(0);
return 0;
default:
return DefWindowProcW(hwnd, msg, wParam, lParam);
}
}
int main() {
WNDCLASSW wc{};
wc.lpfnWndProc = WndProc;
wc.hInstance = GetModuleHandleW(nullptr);
wc.lpszClassName = L"FlowWindow";
wc.hCursor = LoadCursorW(nullptr, IDC_ARROW);
RegisterClassW(&wc);
HWND hwnd = CreateWindowExW(
0, L"FlowWindow", L"message loop demo", WS_OVERLAPPEDWINDOW,
200, 200, 480, 320, nullptr, nullptr, wc.hInstance, nullptr);
std::printf("[create] hwnd=%p\n", static_cast<void*>(hwnd));
ShowWindow(hwnd, SW_SHOW);
UpdateWindow(hwnd);
SetTimer(hwnd, 1, 1500, nullptr);
MSG msg{};
while (GetMessageW(&msg, nullptr, 0, 0) > 0) {
TranslateMessage(&msg);
DispatchMessageW(&msg);
}
std::printf("[loop] exit, wParam=%u\n", static_cast<unsigned>(msg.wParam));
return 0;
}
编译运行:
g++ -std=c++20 message-loop.cpp -o message-loop.exe -lgdi32 -luser32
.\message-loop.exe
本机实际输出:
[create] hwnd=0000000012ef13e2
[msg] WM_PAINT
[msg] WM_TIMER
[msg] WM_CLOSE
[msg] WM_DESTROY
[loop] exit, wParam=0
同一份代码用 MinGW 编译,命令是 g++ -std=c++20 message-loop.cpp -o message-loop.exe -lgdi32 -luser32;换成本机的 MSVC 19.51(VS BuildTools,工具集 14.51.36231),写法是 cl /std:c++20 /utf-8 message-loop.cpp user32.lib gdi32.lib /link /SUBSYSTEM:CONSOLE,库直接写在命令行上,子系统由 /link 之后的参数决定。少写一个库,链接阶段就会报 undefined reference 或 unresolved external symbol,提示里通常带着函数名,照着补就行。
标题栏显示的内容来自 CreateWindowExW 的第二个字符串参数,和 exe 的资源、版本信息没有关系。本机做资源实验时用 MSVC 的 rc 加 cl 编出的那个程序,标题栏写的是「资源验证」,这个名字就是代码里传进去的字符串。把两件事混在一起,会以为「改了 VERSIONINFO 窗口标题就会变」,然后白找半天。
这几行的含义值得逐条看:
WM_PAINT 是在 UpdateWindow 之后来的。窗口第一次显示、被遮挡后恢复、大小改变,系统都会标记「这块区域需要重画」,然后投递 WM_PAINT。它不是定时刷新,而是按需刷新。
WM_TIMER 是低优先级消息。系统在队列空的时候才生成它,而且如果处理不及时,多个定时器消息会被合并成一个。所以定时器不能拿来做精确计时,只能做「大概每隔一会儿提醒我」。
我们在定时器里没有直接 DestroyWindow,而是 PostMessageW(hwnd, WM_CLOSE, 0, 0)。因为 WM_CLOSE 才是「用户想关窗口」的标准入口。直接销毁窗口会跳过一些清理逻辑,也会让「关闭前保存」这类逻辑没有统一的位置。
窗口过程收到 WM_CLOSE 后自己调了 DestroyWindow,于是系统又发来 WM_DESTROY。在 WM_DESTROY 里调用 PostQuitMessage(0),队列里多了一个 WM_QUIT,GetMessageW 返回 0,循环结束,main 返回,进程才真正退出。
如果 WM_DESTROY 里什么都不做,窗口会消失,但消息循环永远等不到 WM_QUIT,进程就留在后台——这就是「窗口关了,任务管理器里还有」的最常见原因。
为什么界面会假死
消息循环跑在 UI 线程上,窗口过程也在这个线程里执行。这意味着:你在按钮点击处理函数里做的任何耗时操作,都会把消息循环堵住。堵住期间,重绘、点击、关闭全部排队,窗口看起来就是白的、灰的、点不动的。
常见的错误写法是在 WM_COMMAND 里直接读一个大文件、等一个网络请求、或者 Sleep(3000)。这三秒里系统不是没收到消息,而是你的线程没空去取。用户点关闭,WM_CLOSE 躺在队列里,程序看起来「卡死」。
还有一种「假死」不是阻塞,而是重绘风暴。比如在 WM_PAINT 里 InvalidateRect 自己,或者在 WM_SIZE 里每次 MoveWindow 都带 TRUE,消息就会自我繁殖,界面一直忙于重画,看起来像卡住,CPU 却很高。区分方法很直接:看任务管理器的 CPU——阻塞型假死接近零,重绘风暴会明显上升。
正确的做法是把耗时工作挪到后台线程,做完再通知 UI 线程。通知时不要直接操作控件——控件属于创建它的线程,从别的线程调用 SetWindowTextW 轻则行为异常,重则崩溃。标准做法是 PostMessage 一个自定义消息回 UI 线程,让 UI 线程自己去更新。
跨平台时要留意,消息循环不是 Windows 独有的概念,但形式不同。X11 和 Wayland 有自己的事件循环,macOS 是 NSRunLoop;Qt 把这些封装成 QApplication::exec,GTK 是 gtk_main。概念相通,API 不通用。
多个窗口与「关不掉的进程」
真实程序很少只有一个窗口。设置对话框、关于窗口、进度窗口、浮动工具栏,都是独立的顶层窗口或子窗口。它们的消息同样进 UI 线程的队列,由各自的窗口过程处理。由此产生一个设计问题:程序什么时候算「该退出了」?
常见的有三种约定。第一种是「主窗口关闭即退出」,适合记事本、计算器这类单文档工具;关闭主窗口时在 WM_DESTROY 里发退出消息,其他窗口跟着销毁。第二种是「关最后一个窗口才退出」,适合多文档编辑器;每个窗口关闭时检查还有没有别的窗口,没有才退出。第三种是「关闭只是隐藏」,托盘程序常用;WM_CLOSE 里 ShowWindow(hwnd, SW_HIDE) 然后 return 0,真正的退出放在托盘菜单里。
三种约定在代码上的差别,其实只在 WM_CLOSE 分支里。系统对关闭按钮的默认处理是发 WM_CLOSE;窗口过程如果不在这个分支里 return 0,消息会继续交给 DefWindowProcW,它再调 DestroyWindow,于是依次收到 WM_DESTROY 和 WM_NCDESTROY。所以「拦截关闭」的正确做法是处理 WM_CLOSE 并明确 return 0:想取消就什么都不做,想继续关就自己调 DestroyWindow。在 WM_DESTROY 里拦是没用的,那时窗口已经在拆了。
系统关机、注销时走的是另一条路:WM_QUERYENDSESSION 问「能不能结束」,WM_ENDSESSION 通知结果。程序如果有未保存的数据,要在这里按规则回应,而不是只盯关闭按钮。很多工具在用户点「关机」时丢数据,就是只处理了 WM_CLOSE。
第三种最容易出问题:用户点了关闭,窗口不见了,但进程还在,托盘图标也还在。如果产品没在界面上说清楚「程序仍在后台运行」,用户会以为程序坏了,再点一次图标又启动一个实例,最后任务管理器里堆了三个进程。要避免这种情况,至少要做两件事:托盘菜单里提供明确的「退出」,以及启动时做单实例检查,第二次启动就把已有窗口叫到前台。
还有一类「关不掉」不是设计,而是 bug:在 WM_CLOSE 里做了保存确认,用户点「取消」后代码忘了 return 0,消息继续走到 DefWindowProcW,系统照样把窗口销毁了;或者反过来,无论用户选什么都 return 0 却不销毁窗口,点了关闭毫无反应。这两种写法在代码 review 时很难一眼看出,实际表现却完全相反。
多窗口之间共享数据也要小心。同一个 UI 线程内不需要加锁,但一个窗口改了数据,另一个窗口的界面不会自动更新——除非你显式通知它重绘或刷新控件。这就是后面 Qt 的模型视图要解决的问题:让「数据变了」这件事有统一的广播机制,而不是每个窗口各自记得刷新。
出问题时先看哪里
| 现象 | 真实原因 | 第一步查什么 |
|---|---|---|
| 窗口闪一下就消失,进程退出 | 只创建了窗口,没有进入消息循环,main 直接返回 | 确认 GetMessageW 循环存在,且循环条件不是一进来就为假 |
| 窗口关掉了,进程还在任务管理器里 | WM_DESTROY 里没有 PostQuitMessage,循环等不到 WM_QUIT | 在 WM_DESTROY 分支打断点或打日志,确认是否调用了 PostQuitMessage |
| 点按钮后界面白屏、点不动,几秒后恢复 | 在 UI 线程里做了耗时操作,消息循环被阻塞 | 在点击处理函数里加日志或计时,找出超过 100ms 的那一段 |
| 窗口不重绘,拖动后才正常 | WM_PAINT 没处理,或者处理时没调用 BeginPaint/EndPaint | 检查 WM_PAINT 分支,确认调用了 BeginPaint 并且返回 0 |
| 空闲时 CPU 占用接近 100% | 用 PeekMessage 死循环轮询,没有等待消息 | 看循环里是否缺少 GetMessage 的阻塞等待,或缺少 WaitMessage |
| 跨线程更新控件后随机崩溃 | 在非 UI 线程直接调用了控件 API | 确认更新动作发生在创建窗口的那个线程,或改成 PostMessage 回 UI 线程 |
| 点关闭按钮没反应 | WM_CLOSE 被处理了但没有销毁窗口,也没有交给 DefWindowProc | 检查 WM_CLOSE 分支是否 return 0 却没有 DestroyWindow |
边界与代价
第一,裸 Win32 的消息处理是手写 switch,消息越多,窗口过程越臃肿。一个中等复杂度的界面,WndProc 写到几百行很常见。Qt 用信号槽把「哪个控件、什么事件」拆成独立连接,代码组织会好很多,但底层仍是同一套事件分发。
第二,消息循环是单线程模型。它带来简单——不用考虑锁和并发;也带来限制——任何阻塞都会直接反映到界面上。这不是 Win32 的缺陷,几乎所有 GUI 框架都这样,包括 Qt、Electron、Cocoa。
第三,消息的顺序不保证完全如你所想。重绘消息会合并,定时器消息会合并,PostMessage 的消息排在其他消息后面。SendMessage 看起来「立即执行」,但跨线程时可能死锁。写界面逻辑时不要依赖「消息一定按某个顺序到达」。
第四,关闭流程要自己设计。是关最后一个窗口就退出,还是最小化到托盘?是有未保存内容时拦截 WM_CLOSE 弹确认框,还是直接销毁?这些都要在 WM_CLOSE 里写清楚,不能指望默认行为覆盖所有产品需求。
第五,输入消息的优先级高于 WM_PAINT 和 WM_TIMER。系统总是先处理鼠标、键盘,再处理重绘和定时器,所以拖动窗口时重绘会变慢、定时器会漂移。这不是缺陷,而是「界面要跟手」的取舍。任何按毫秒计时的需求,都不该建在 WM_TIMER 上。
WM_PAINT 里做业务计算或创建控件。重绘可能一秒钟来很多次,把它当成「画当前状态」的时机,而不是「改变状态」的时机。否则会出现越画越慢、控件重复创建的怪问题。小结
记住三句话:窗口是系统托管的区域,消息循环才是程序的心跳;关闭窗口靠 WM_CLOSE,退出循环靠 PostQuitMessage,两者不是同一件事;UI 线程一旦被阻塞,界面就假死。
当天可以自己验证的练习:
- 把
WM_DESTROY里的PostQuitMessage(0)注释掉,关掉窗口后去任务管理器看进程是否还在,再手动结束它。 - 在
WM_TIMER里加一句Sleep(3000),运行后试着拖动窗口,观察卡顿。 - 把
GetMessageW换成PeekMessageW并且不等待,运行后看任务管理器的 CPU 占用。 - 在
WM_CLOSE里弹一个MessageBoxW询问是否退出,选择「否」时直接return 0,验证窗口不会关。 - 用
spy++或 Visual Studio 的 Spy 工具观察窗口收到的消息,对照本文的输出顺序。
下一篇讲控件、事件与布局。窗口已经能开能关,接下来要往里放按钮、输入框和列表;那时你会发现,控件也是窗口,点击事件同样走 WM_COMMAND,只是多了一层父子关系和坐标计算。