前几年帮一个做硬件的团队收拾过一个串口日志工具。需求用一句话就能说完:选一个 COM 口,点开始抓日志,按行解析,导出 CSV,界面上有开始、停止和一个滚动文本框。团队先拿 Electron 做了原型,功能能跑,但装完 180MB;现场那批工控机是四核赛扬、4GB 内存,程序设成开机自启以后,风扇从早转到晚。
后来换成 C++ 加 Qt,安装包 30MB 左右,空闲内存三十几 MB,串口读数延迟也从几十毫秒降到几毫秒。代价是两个人多花了三周,其中一周在跟构建、运行时库和打包较劲。
这个例子不是要证明「C++ 更好」。Electron 那版原型三天就出了演示,如果这个工具只给办公室十个人用,它完全够。真正决定选型的是运行环境:内存小、要碰串口、要长期驻留、不能依赖在线更新。这篇就把 C++ 桌面能做什么、要付什么代价摆开讲清楚,让你在下一个项目里能自己做判断。
本文按 C++20、Win32 API 与 Qt 6 讲解,所有内容在 Windows 11 上验证。Win32 那几篇的示例用 MSYS2 的 MinGW g++ 16.2 编译,命令一行就能跑完;Qt 部分用 MSVC 19.51(VS BuildTools,工具集 14.51.36231)、CMake 4.4.4 和 Qt 6.8.3。同一份代码换编译器,命令行参数不同,API 行为一致。
先看一个最小桌面程序
桌面程序和命令行程序最直观的差别,是它有一个由系统托管的窗口。下面这段代码创建了一个 480×320 的窗口,两秒后自动关闭,完整可编译:
#define UNICODE
#define _UNICODE
#include <windows.h>
#include <cstdio>
LRESULT CALLBACK WndProc(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam) {
switch (msg) {
case WM_TIMER:
DestroyWindow(hwnd);
return 0;
case WM_DESTROY:
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"FirstWindow";
if (!RegisterClassW(&wc)) return 1;
HWND hwnd = CreateWindowExW(
0, L"FirstWindow", L"第一个窗口", WS_OVERLAPPEDWINDOW,
200, 200, 480, 320, nullptr, nullptr, wc.hInstance, nullptr);
if (!hwnd) return 1;
std::printf("[create] hwnd=%p\n", static_cast<void*>(hwnd));
ShowWindow(hwnd, SW_SHOW);
SetTimer(hwnd, 1, 2000, nullptr);
MSG msg{};
while (GetMessageW(&msg, nullptr, 0, 0) > 0) {
TranslateMessage(&msg);
DispatchMessageW(&msg);
}
std::printf("[exit] message loop finished\n");
return 0;
}
把文件存成 first-window.cpp,在 PowerShell 里编译并运行:
g++ -std=c++20 first-window.cpp -o first-window.exe -lgdi32 -luser32
.\first-window.exe
本机实际输出(窗口会弹出两秒,然后自己关掉;hwnd 每次都不一样):
[create] hwnd=00000000007c06e2
[exit] message loop finished
六十行代码换来一个空白窗口,这就是第一笔成本。它没有菜单、没有控件、没有图标,标题栏上的关闭按钮能生效只是因为系统默认处理了 WM_CLOSE。如果你要的是「输入一个路径、点一下按钮、显示结果」,这六十行还只是地基。
printf 的输出能看到。正式发布时通常加 -mwindows(MSVC 是 /SUBSYSTEM:WINDOWS)去掉控制台黑框,入口也换成 WinMain,消息循环的写法不变。桌面程序由哪几层组成
把「能跑」和「好用」分开看,一个 Windows 桌面程序大致是四层。理解分层比背 API 有用,因为每一层出问题的症状完全不同。
新手最容易忽略的是第四层。开发机上什么都有,因为装编译器时顺手装了一堆运行库;客户机上没有,于是出现「我这能跑,你那打不开」。第 7 篇会把这件事单独拆开算账,这一篇先记住:桌面程序的交付物从来不只是那个 exe。
判断自己的程序到底依赖哪一层,不用猜:MSVC 下用 dumpbin /dependents xxx.exe,MinGW 下用 objdump -p xxx.exe,导入表会把你需要的每个 DLL 列出来。列在表里而目标机没有的,就是你要补的东西。这个动作在开发机上做一次,比到了客户机上靠「打不开」猜半天有用。
跨平台也是分层带来的。Win32 这一层是 Windows 独有的;Qt 把界面层和系统层包在自己的抽象里,同一份代码可以编到 macOS 和 Linux,但托盘、文件关联、安装方式仍然要写平台分支。所以后面讲到「Windows 上怎么做」时,不要默认它在 macOS 上也成立。
C++ 桌面到底能做什么
把 C++ 用在桌面,通常不是为了「写界面快」,而是为了下面这些事:
- 贴着系统干活。串口、USB HID、注册表、Windows 服务、文件关联、右键菜单、系统托盘、全局快捷键、拖放、剪贴板、COM 组件,这些能力在 C++ 里是一等公民,调起来没有中间层。
- 处理大文件和大数据量。几个 GB 的日志、几十万行的表格、实时绘制的波形,C++ 的内存控制和零拷贝手段更多。同样的活,脚本语言要么爆内存,要么慢到不能用。
- 对启动时间和内存有硬要求。工控机、收银机、车载设备、老旧办公机,这些场景里「装完 200MB、开机先等五秒」是不能接受的。
- 对接厂商 SDK。很多硬件、工业相机、加密狗的 SDK 只提供 C/C++ 头文件和 DLL。别的语言要用就得先包一层,出问题时链条更长。
- 离线、内网、长期不更新。程序拷进 U 盘就能装,不依赖在线服务,不强制升级,这对很多生产环境是刚需。
- 性能敏感的计算。图像处理、音视频转码、仿真、加密解密,C++ 可以直接用现成的 C 库,也可以自己写 SIMD 和线程池。
反过来说,如果需求是「带登录、表格、表单、报表的管理系统」,C++ 并不划算。这类界面用 C#、Electron、Tauri 甚至一个本地网页壳都快得多,C++ 的优势在那些地方体现不出来,反而要额外承担内存管理和构建复杂度。
把量级摆在一起看更清楚:本机带图标和版本信息的 Win32 程序编出来 174.5 KB;Qt 版可执行文件只有 56.0 KB,但发布目录是 15 个文件、29.3 MB。体积账不能只算 exe,要把同目录的库一起算,否则选型时很容易被「才几十 KB」这个数字骗过去。
两条主流路线:Win32 与 Qt
Windows 上写 C++ 桌面,实际落地基本是两条路。它们不是「新旧」关系,而是控制力和开发效率的交换。
Win32 原生
直接调 CreateWindowExW、SendMessageW 这些 API。产物小,一个简单工具通常在几百 KB 到 2MB;不依赖第三方运行库;系统集成最直接。代价是样板代码多,控件是二十年前的外观,布局要自己算坐标,High DPI、字体、主题都得手写。适合界面简单、要求轻量、只跑 Windows 的内部工具。
Qt 6
控件齐全,布局、模型视图、信号槽、国际化、样式表都是现成的,同一份代码能编到三大平台。代价是动态库体积大(发布目录常在 40–80MB),要处理平台插件和许可合规(LGPL 动态链接或商业授权),学习和构建成本也更高。适合界面复杂、要长期迭代、或者需要跨平台的产品。
还有第三条常被忽略的路:用系统自带的 WebView 装一个网页界面,C++ 只做后端。它在「界面要好看、逻辑要碰硬件」的项目里很实用,但渲染一致性、调试链路和包体都要单独评估。Rust 那边的 Tauri 走的就是这个思路,后面 Rust 桌面系列会展开。
Qt 的许可也是选型时绕不开的一条:LGPL 下动态链接可以商用,但要保证用户能替换 Qt 库;静态链接则要额外满足条件,或者购买商业授权。这不是技术问题,却会在发布前变成法务问题,早问一句比上线前一周再去补强。
本系列的选择是:先用 Win32 把窗口、消息、控件、文件这些底层概念讲透,再切到 Qt 做完整工具。原因很实际——不理解消息循环,用 Qt 也会在「界面卡死」「跨线程更新崩溃」上反复踩坑;而 Qt 的信号槽、模型视图,本质上都是对同一套事件模型的高层封装。
从需求到能跑:一次完整走查
假设现在就要做那个串口日志工具。完整路径大致是这样:
这套流程在本机走过一遍,先把结果摆出来。工具链是 CMake 4.4.4、MSVC 19.51(VS BuildTools,工具集 14.51.36231)、Qt 6.8.3(win64_msvc2022_64 套件)。Qt 用 aqtinstall 只装 qtbase,共 4083 个文件、267 MB,安装耗时 56 秒,落在 C:\Users\c1805\Qt。配置用 cmake -S . -B build -DCMAKE_PREFIX_PATH=C:/Users/c1805/Qt/6.8.3/msvc2022_64,构建用 cmake --build build --config Release,产物 qtlab.exe 只有 56.0 KB。
启动用 Start-Process 加 WaitForInputIdle,等到窗口可交互,耗时 275 ms。程序自己的前两行输出是 [qt] 版本 "6.8.3" 平台插件 "windows" 和 [window] QMainWindow 已构造,size = QSize(640, 480)。前者说明 Qt 库链接成功、平台插件加载成功;后者说明窗口尺寸真的按代码设成了 640×480。275 ms 这个数的口径也要说清:它等的是进程进入空闲、能接受输入,不是第一帧画完,所以适合比较同一台机器上的不同框架,不等于用户感知的全部启动时间。
发布目录不是手拷 DLL 拼出来的。执行 windeployqt --release --no-translations .\build\Release\qtlab.exe,补出 15 个文件、29.3 MB:Qt6Gui.dll 9068 KB、Qt6Widgets.dll 6348 KB、Qt6Core.dll 6015 KB、D3Dcompiler_47.dll 4560 KB、Qt6Network.dll 1714 KB、platforms\qwindows.dll 886.6 KB。一个 56 KB 的 exe 离开开发机要背 29.3 MB 的库,这就是「Qt 的代价在分发」最直白的证据。
安装规则也验证了:cmake --install build --config Release --prefix stage 之后,stage\bin\qtlab.exe 存在。这一步看着平淡,却是打包篇的地基——安装规则写对,安装包才有东西可装;写错,安装包会提示「安装成功」,目录里却空空如也。
29.3 MB 能不能靠静态链接 Qt 压下去?本机装的是共享版 Qt,没有静态库,所以这条路径没有验证,卡在缺一份静态构建的 Qt 上。官方 Windows 包默认也是共享版;要做静态 Qt,得先用 MSVC 自己编一份,编译时间和磁盘占用都要另算。
第一步的约束清单里,最容易被漏掉的是「目标机器的系统版本」和「有没有管理员权限」。它们直接决定你能用哪些 API、配置能写到哪、安装包要不要提权。第二第三步看起来是技术活,实际上是团队约定:MSVC 和 MinGW 的 C++ ABI 不兼容,预编译的第三方库通常只认其中一种;Qt 官方 Windows 包是 MSVC 构建的,用 MinGW 编 Qt 程序要么自己编 Qt,要么放弃官方二进制。本机两套工具链都装着:MSVC 19.51(工具集 14.51.36231)和 MinGW g++ 16.2。Win32 示例仍用 MinGW,是因为编译命令一行就能跑完,不用先开 Visual Studio 的开发者命令行;Qt 工程走的却是 MSVC 加 CMake。真实项目建议尽快统一到 MSVC,别让两套工具链编出的库在同一个工程里碰面。
第四步是分水岭。空窗口能弹出来、能正常关掉、进程能退出,说明工具链、链接参数、入口点、消息循环都对了。很多后续问题(缺 DLL、界面不刷新、关不掉)其实在这一步就能暴露,只是新手急着写业务代码,把地基跳过了。
第五步开始才是业务。串口读取是阻塞的,放在 UI 线程里点「开始」就会假死,这一点第 2 篇会从消息循环的角度解释清楚。最后一步打包,则是第 7 篇的主题:你在开发机上永远感受不到客户机缺什么,直到真的拿到一台干净机器。
出问题时先看哪里
下面这些现象在 C++ 桌面项目里出现频率极高。表里给的是「第一反应该查什么」,不是完整排查手册,但能帮你少走半天弯路。
| 现象 | 真实原因 | 第一步查什么 |
|---|---|---|
| 双击 exe 完全没反应 | 进程启动即退出,或被杀毒软件拦截,或缺少运行库导致加载失败 | 在命令行里运行同一个 exe,看有没有报错;再查 Windows 事件查看器里的应用程序错误 |
提示缺少 VCRUNTIME140.dll 或 libstdc++-6.dll | 动态链接了 C++ 运行库,但目标机没装 | 用 dumpbin /dependents 或 objdump -p 看导入了哪些 DLL,再决定静态链接还是随包分发 |
Qt 程序启动报找不到 windows 平台插件 | platforms/qwindows.dll 没跟着发布,或插件路径不对 | 看发布目录下有没有 platforms 子目录,用 windeployqt 补齐 |
| 界面中文变成方块或乱码 | 用了 ANSI 版 API、源文件编码不对,或字体不含中文字形 | 确认调用的是 ...W 结尾的宽字符 API,源文件存 UTF-8,并显式设置中文字体 |
| 高分屏上字发虚、控件错位 | 进程没有声明 DPI 感知,系统按 96 DPI 拉伸了整个窗口 | 查清单文件或 SetProcessDpiAwarenessContext 的调用,再处理 WM_DPICHANGED |
链接时报 undefined reference | 库没链接、位数不匹配,或 MSVC/MinGW 的 ABI 混用 | 确认库的架构(x86/x64)、编译器家族和链接参数三者一致 |
| 开发机能跑,客户机提示缺文件 | 程序按「当前工作目录」找文件,而快捷方式的工作目录不是 exe 所在目录 | 把路径改成基于 GetModuleFileNameW 的 exe 目录,第 4 篇详讲 |
边界与代价
第一,开发效率真的低。同样一个带表单和列表的界面,C# WinForms 半天能出,C++ 裸 Win32 要两三天,Qt 大概一天半。C++ 的优势要在运行期才兑现,前期投入是实打实的。
第二,内存安全要靠自己。空指针、悬垂指针、越界、重复释放,编译器不会全帮你挡住。C++20 有 std::span、智能指针、std::string_view 这些工具,但用不用、用对没用对,仍然取决于写代码的人。桌面程序往往要长时间运行,一个小泄漏在演示时看不出来,在现场跑一周就是事故。
第三,构建和分发是独立技能。编译参数、运行库、静态链接、图标资源、安装包、代码签名、自动更新,每一块都能单独写一篇。很多 C++ 桌面项目不是死在功能上,而是死在「装不上」和「升不了级」。
第四,生态偏底层。遇到问题,搜到的答案经常是十年前的论坛帖,或者只有一句「看 MSDN」。新库的文档质量参差不齐,很多东西得读头文件和源码。这不是不能做,是要有心理准备。
第五,界面审美上限取决于框架。裸 Win32 控件就是系统原生外观,想做好看得自己绘制;Qt 能做得更现代,但要学样式表和委托绘制。如果产品对界面要求很高,纯 C++ 方案通常要配一个专门做视觉的人。
这五条不是劝退,而是让你在评审时能把成本说出口。能接受这些代价的团队,通常已经有明确的运行环境约束;不能接受的,选 C# 或 Tauri 更省事。判断标准不是「C++ 快不快」,而是「这些约束值不值多付的几周工期」。
小结
这篇没有教你任何控件,只想让你在动手前把账算明白:C++ 桌面强在贴近系统、体积可控、能碰硬件、长期离线运行;弱在开发效率、内存安全、构建分发和界面生态。Win32 给你控制力,Qt 给你效率,选哪条取决于界面复杂度和团队栈。
当天可以自己验证的练习:
- 把上面的最小窗口编译出来,改成 1 秒后关闭,确认进程能自己退出。
- 去掉
-lgdi32 -luser32里的任意一个,看链接器报什么错,理解「用到的 API 要链接对应的库」。 - 把
CreateWindowExW的宽度改成 0,观察窗口是否还能出现,想想为什么。 - 用
objdump -p first-window.exe看一下它依赖哪些 DLL,记下哪些是系统自带、哪些是编译器带进来的。 - 拿你手上一个真实的小工具需求,列出「离线、内存、硬件、启动时间」四条约束,判断该不该用 C++。
下一篇讲窗口与消息循环。上面那六十行里,真正让程序「活着」的不是 main,而是那个 while (GetMessageW(...))。搞不清它,后面所有「界面卡死」「关不掉」「进程残留」的问题都只能靠猜。