前几年帮一个做硬件的团队收拾过一个串口日志工具。需求用一句话就能说完:选一个 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 有用,因为每一层出问题的症状完全不同。

界面层窗口、按钮、输入框、列表、绘制。用户看到的、点的,都在这一层。它决定「像不像一个正常程序」。
框架层Win32 裸 API、Qt、MFC、WTL、Dear ImGui 这些。负责把「创建一个按钮」翻译成几十条系统调用,也负责布局、事件分发、重绘调度。
系统层窗口管理器、消息队列、文件系统、注册表、串口、剪贴板、托盘。这一层是操作系统给的,跨平台时差别最大。
运行时层C 运行库、C++ 标准库、VC++ 运行库或 MinGW 的 libstdc++、Qt 的动态库。这一层决定你的程序拷到别人机器上能不能启动。

新手最容易忽略的是第四层。开发机上什么都有,因为装编译器时顺手装了一堆运行库;客户机上没有,于是出现「我这能跑,你那打不开」。第 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 的信号槽、模型视图,本质上都是对同一套事件模型的高层封装。

从需求到能跑:一次完整走查

假设现在就要做那个串口日志工具。完整路径大致是这样:

从需求到第一个可运行版本
定约束系统版本、内存、是否离线、要不要碰硬件
选框架界面简单选 Win32,复杂或跨平台选 Qt 6
装工具链MSVC 或 MinGW,只选一套,别混用
跑空窗口先验证编译、链接、消息循环
接硬件串口读写放到后台线程
做打包补运行库、图标、安装包

这套流程在本机走过一遍,先把结果摆出来。工具链是 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++ 快」就选它。桌面程序的瓶颈通常在 IO、网络和界面刷新,不在语言。先写清楚需求里的硬约束(内存、离线、硬件、启动时间),再决定值不值得为这些约束多付几周开发时间。

小结

这篇没有教你任何控件,只想让你在动手前把账算明白:C++ 桌面强在贴近系统、体积可控、能碰硬件、长期离线运行;弱在开发效率、内存安全、构建分发和界面生态。Win32 给你控制力,Qt 给你效率,选哪条取决于界面复杂度和团队栈。

当天可以自己验证的练习:

  1. 把上面的最小窗口编译出来,改成 1 秒后关闭,确认进程能自己退出。
  2. 去掉 -lgdi32 -luser32 里的任意一个,看链接器报什么错,理解「用到的 API 要链接对应的库」。
  3. 把 CreateWindowExW 的宽度改成 0,观察窗口是否还能出现,想想为什么。
  4. 用 objdump -p first-window.exe 看一下它依赖哪些 DLL,记下哪些是系统自带、哪些是编译器带进来的。
  5. 拿你手上一个真实的小工具需求,列出「离线、内存、硬件、启动时间」四条约束,判断该不该用 C++。

下一篇讲窗口与消息循环。上面那六十行里,真正让程序「活着」的不是 main,而是那个 while (GetMessageW(...))。搞不清它,后面所有「界面卡死」「关不掉」「进程残留」的问题都只能靠猜。