搞 Windows 桌面端开发的人绕不开 MFC 这三个字母。哪怕你平时主力写的是 Qt、WPF 或者别的什么框架只要接手过一些年头比较久的工业上位机、仪器仪表配套软件、行业内部工具十有八九会在源码目录里看到一对.h/.cpp里面全是C打头的类名和一堆ON_WM_XXX宏。MFCMicrosoft Foundation Class是微软在九十年代初推出的 C 类库把 Win32 API 用面向对象的方式薄薄包了一层顺手把窗口注册、消息循环、文档数据管理这些脏活累活都兜住了。这组笔记我打算从零捋一遍第一篇先把三件事说透它是什么、工程怎么建、代码到底是怎么跑起来的。如果你是完全没碰过 MFC 的新手或者以前跟着教程敲过一遍但始终没搞明白向导生成的那堆文件谁调用谁这篇应该能帮你把地基打上。环境我用 VS2019 和 VS2022 为主老版本比如 VS2010的差异我会单独标出来。1. 先搞清楚 MFC 到底是个什么东西1.1 它解决的是哪个年代的什么痛点要理解 MFC 为什么长成这样得先回到没有它的年代。Windows 3.x 时期写一个窗口程序标准流程是定义 WNDCLASS、调用 RegisterClass、CreateWindow、ShowWindow、UpdateWindow然后写一个巨大的 WndProc里面一个switch(msg)接住WM_CREATE、WM_PAINT、WM_SIZE、WM_COMMAND等几十上百种消息每个分支还得自己处理句柄转换、参数拆包、GDI 对象申请和释放。一个带菜单、能响应按钮点击的Hello World纯 Win32 API 写下来一百多行是起步价而且所有窗口的 WndProc 长得都差不多属于纯粹的重复劳动。MFC 的核心思路就是把这些重复模式抽象成类。CWnd封装HWNDCWinApp封装整个应用程序实例CDC封装HDCCGdiObject及其派生类封装各种 GDI 对象。最关键的改动是消息处理不再写巨型 switch而是用一组宏把你的处理函数登记到一张表里运行时按消息查表调用。这套机制叫消息映射是 MFC 区别于普通 Win32 封装库的分水岭也是后面第 3 章要重点拆的东西。1.2 MFC 和 Win32 API、Qt、WinForms 摆一起怎么选很多新手会问现在学 MFC 还有没有意义。我的看法是把它当成一门维护技能和底层理解工具而不是新项目首选。下面这张表是我自己选型时会过的几个维度供你参考维度原生 Win32 APIMFCQt.NET WinForms/WPF开发语言CCC / QMLC# / VB.NET封装程度无薄封装几乎能穿透到底层自绘控件体系跨平台托管封装跨语言学习曲线陡中等坑在文档少中等偏缓平缓界面现代化要自己画要自己画或用第三方库开箱好看开箱好看部署依赖无VC 运行库静态链接可免Qt 运行库.NET 运行时现存老项目数量多非常多多多调试便利性好好和 VS 深度集成一般好MFC 真正的优势在于生成的是原生控件程序体积小不依赖额外的运行时框架可以直接插 Win32 API 调用跟 Visual Studio 的调试器、资源编辑器、类向导贴合得极深。劣势也很明显界面风格停留在上个时代自带控件数量少没有真正的布局管理器要手动算坐标或者用第三方官方文档更新频率极低。至于那些把 MFC 说成过时垃圾的论调我的态度是——技术选型看场景接手一个几十万行的 MFC 老项目时能读懂BEGIN_MESSAGE_MAP比会写 React 有用得多。1.3 学 MFC 之前你得先有点什么底子不用等到 C 精通但下面这几样必须过关否则后面全是玄学。第一是类和继承MFC 里几乎所有对象都从CObject派生虚函数覆盖是家常便饭第二是Windows 消息机制的基本概念知道什么是窗口句柄、消息队列、PostMessage和SendMessage的区别第三是句柄类型HWND、HDC、HINSTANCE、HANDLE这些别搞混MFC 里GetSafeHwnd()这类函数到处都是第四也是新手最容易栽的字符集的坑。MFC 从 VS2005 起默认用 Unicode宽字符TCHAR、_T()、L、CString的行为和你在控制台里写char*的习惯完全不同很多编译报错都是这里来的。2. 开发环境准备与工程创建全流程2.1 VS 版本挑哪个安装时别漏了什么先解决一个经典问题为什么我新建项目时在模板列表里搜不到MFC 应用答案几乎只有一个——装 VS 的时候没勾 MFC 组件。打开 Visual Studio Installer找到你装的那个版本点修改在工作负载页确认勾选了使用 C 的桌面开发然后在右侧的安装详细信息里往下翻找到适用于最新 v143 生成工具的 C MFCx86 和 x64这一项勾上点右下角修改。装完重启 VS模板就出来了。VS2019 和 VS2022 的操作完全一样只是平台工具集版本号不同。如果你还在用 VS2010那不用额外装MFC 是随 IDE 一起带的但要注意 VS2010 默认的 MFC 版本和现在的差异较大部分CMFCxxx开头的类在 VS2010 上是不存在的比如CMFCButton、CMFCColorButton这些是 VS2008 SP1 的 Feature Pack 才引入VS2010 有但更早的没有。另外提醒一句安装 MFC 组件会占大概 1 到 2 GB 磁盘空间如果你的 C 盘紧张可以只勾 x64 版本x86 那半边不装也能跑只是将来打包 32 位程序时得补上。2.2 向导里的每一页该怎么选新建项目选MFC 应用输入项目名点确定就进入 MFC 应用程序向导。这个向导一共六七页我按重要程度排一下把每页的实际含义讲清楚第一页应用程序类型是整份向导里最重要的一个选择单个文档SDI程序一次只能打开一个文档像记事本。适合大多数数据查看类工具。多个文档MDI一个主窗口里能开多个子窗口像老版 Photoshop。适合同时操作多份数据的场景。基于对话框整个程序就是一个对话框没有菜单栏和状态栏。适合配置工具、小计算器这类没有文档概念的软件。新手我强烈建议从这个类型起步因为它的代码最少、结构最直白。多个顶级文档每个文档一个独立顶层窗口类似现代浏览器那种多窗口模式。下面还有一个项目样式下拉选Visual Studio会生成带停靠窗格、属性页、现代外观的界面选MFC 标准则是最朴素的老样式。新手选 MFC 标准代码干净好读。第二页复合文档支持除非你要做 OLE 嵌入比如在文档里嵌 Excel 表格一律选无。第三页文档模板字符串这里填三个值标题程序窗口标题栏显示的文字、文件扩展名、以及资源 ID。文件扩展名会跟文件-打开/保存绑定如果你做的是 SDI 记事本类程序就填txt。第四页数据库支持选无。MFC 自带的那套 ODBC 数据库封装CRecordset已经是老古董了真要连数据库不如直接用新的库。第五页用户界面功能有几个勾功能区、经典菜单、工具栏、停靠窗格、状态栏。如果你就是想看最传统的界面取消功能区勾上经典菜单和工具栏。第六页高级功能一堆东西上下文相关帮助、打印和打印预览、自动化、ActiveX 控件、MAPI、Windows 套接字、以及一个 CRT 头文件选项。这里按需勾一般保留打印和打印预览就行。最后一页生成的类会列出向导准备生成的类名和基类。新手在这一页可以顺手改项目前缀比如把CMfcApplication1App改成CMainApp省得后面一个个改名。2.3 向导生成的文件清单逐个拆解以单个文档 MFC 标准样式为例向导会给你生成下面这一套东西我按调用顺序和重要性排一下文件作用你需要改它的频率pch.h/stdafx.h预编译头把所有公共头文件塞这里极低framework.h框架相关的公共包含低targetver.h指定目标 Windows 最低版本升 VS 时看一眼XxxApp.h/.cpp应用程序类从CWinApp派生中MainFrm.h/.cpp主框架窗口从CFrameWnd派生高XxxDoc.h/.cpp文档类从CDocument派生高XxxView.h/.cpp视图类从CView派生最高Xxx.rc资源脚本菜单、图标、字符串都在里面高resource.h资源的 ID 宏定义中res\目录图标、位图等二进制资源低需要特别注意pch.h的用法每个.cpp文件的第一行注释之外必须是#include pch.h否则会报C1010: 在查找预编译头时遇到意外的文件结尾。这个坑新手百分百会踩因为手动新建的.cpp文件默认没有这行。3. MFC 核心运行机制拆解3.1 从 WinMain 到 InitInstance程序到底是怎么启动的问题的关键来了打开向导生成的工程搜索WinMain你会发现根本搜不到可程序明明能跑起来。原因在于MFC 自己提供了一个 WinMain藏在appmodul.cpp这个文件里源码位置大概在VS安装目录\VC\Tools\MSVC\版本号\atlmfc\src\mfc\appmodul.cpp。它的完整启动链路是这样的你在XxxApp.cpp里写了CXxxApp theApp;这个全局对象。C 保证全局对象在main之前构造它的构造函数里会把自己的this指针存到 MFC 的全局变量afxCurrentWinApp。CRT 启动后链接器把入口点指向 MFC 的_tWinMain在appmodul.cpp里而不是你自己写的 main。_tWinMain调用AfxWinMain后者依次执行AfxWinInit初始化模块状态、加载资源句柄、处理命令行→pApp-InitApplication()→pApp-InitInstance()。InitInstance是你唯一需要自己写的启动逻辑向导已经帮你填好了骨架构造文档模板、解析命令行、创建主框架窗口、ShowWindow(SW_SHOW)、UpdateWindow()。回到AfxWinMain调用pApp-Run()进入消息循环GetMessage/TranslateMessage/DispatchMessage。消息循环退出后调用pApp-ExitInstance()然后清理收尾。理解这条链路的最大价值是当你在InitInstance里做了什么马上就能对应上程序刚启动的那一刻。比如你想在程序启动时读一个配置文件正确位置就是InitInstance里ShowWindow之前想等窗口显示后再做就放到MainFrm::OnCreate或视图的OnInitialUpdate里。3.2 消息映射MFC 是怎么把巨型 WndProc 拆散的传统 Win32 的消息处理长这样LRESULT CALLBACK WndProc(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam) { switch (msg) { case WM_PAINT: // 绘制 break; case WM_LBUTTONDOWN: // 响应点击 break; case WM_COMMAND: // 处理菜单和按钮 break; default: return DefWindowProc(hWnd, msg, wParam, lParam); } return 0; }MFC 把它拆成了消息映射表 成员函数。你在类里写三个宏// 头文件里 class CMainFrame : public CFrameWnd { DECLARE_MESSAGE_MAP() public: afx_msg void OnPaint(); afx_msg void OnLButtonDown(UINT nFlags, CPoint point); afx_msg void OnFileNew(); }; // 源文件里 BEGIN_MESSAGE_MAP(CMainFrame, CFrameWnd) ON_WM_PAINT() ON_WM_LBUTTONDOWN() ON_COMMAND(ID_FILE_NEW, CMainFrame::OnFileNew) END_MESSAGE_MAP()展开之后BEGIN_MESSAGE_MAP定义了一个静态的AFX_MSGMAP_ENTRY结构体数组每条ON_WM_XXX就是数组里的一行记录消息号、控件 ID、处理函数签名、函数指针这几样东西。同时它定义了两个静态函数GetThisMessageMap()返回这张表GetMessageMap()是虚函数返回当前对象的表。数组最后一项是空的哨兵并且通过pBaseMap指向父类的表。运行时系统回调AfxWndProcMFC 的全局窗口过程它做两件事先通过CWnd::FromHandlePermanent把HWND还原成 C 对象的this指针然后调用this-WindowProc。WindowProc内部走OnWndMsg去查当前类的消息映射表没找到就沿着pBaseMap链往上找这就是为什么子类能覆盖父类的消息处理一路找到顶层都没有才落到DefWindowProc。这里有个常被忽略的细节OnWndMsg先查WM_COMMAND和WM_NOTIFY这类反射消息再查普通消息。所以如果你给按钮的处理函数没被调用第一件事就是确认按钮的 ID 和ON_BN_CLICKED(IDC_BUTTON1, ...)里的 ID 一致第二件事确认这个按钮是当前窗口的子控件否则要在父窗口处理。3.3 文档/视图架构到底解决了什么问题MFC 的文档/视图Document/View架构由四个角色组成CDocument管数据CView管显示和用户交互CFrameWnd提供外框菜单、工具栏、状态栏挂在这里CDocTemplate是胶水把前三者绑成一个文档类型。SDI 用CSingleDocTemplateMDI 用CMultiDocTemplate。它想解决的问题是数据与显示分离。一个CDocument可以挂多个CView比如同一份销售数据左边用一个表格视图显示清单右边用曲线视图显示趋势两个视图共享同一份数据对象。修改数据后文档调用UpdateAllViews()所有挂在上面的视图收到通知并重绘。这个模式在数据可视化类软件里非常有效。第二个好处是免费获得文件读写。CDocument有一个虚函数Serialize(CArchive ar)你只要在里面把成员变量按顺序流进流出框架就帮你把文件-打开文件-保存另存为全部串好了void CMyDoc::Serialize(CArchive ar) { if (ar.IsStoring()) { ar m_nValue m_strName; } else { ar m_nValue m_strName; } }代价是对小工具来说这是过度设计。如果你只是写一个串口调试助手或者配置对话框用基于对话框类型能省掉文档类、视图类、文档模板这一整坨东西。我见过不少人硬套 SDI 去写工具软件结果在OnDraw和UpdateAllViews之间来回绕反而更乱。3.4 运行时类型信息与动态创建MFC 早于 C 标准 RTTI 出现所以它自造了一套运行时类型系统核心是CRuntimeClass结构体里面存着类名、对象大小、以及一个指向基类的指针。你在类里写DECLARE_DYNAMIC(CMainFrame)在源文件里写IMPLEMENT_DYNAMIC(CMainFrame, CFrameWnd)MFC 就会为这个类生成一个静态的CRuntimeClass对象并把RUNTIME_CLASS(CMainFrame)变成取这个对象的宏。这套东西的实用价值是动态创建用DECLARE_DYNCREATE/IMPLEMENT_DYNCREATE声明的类可以通过CRuntimeClass::CreateObject()在运行时按名字创建对象。文档模板就是这样创建文档、视图、框架的——框架启动时并不知道具体要创建哪个类只有文档模板里存的一个CRuntimeClass*指针靠它才把对象造出来。所以如果你删掉或改名了某个IMPLEMENT_DYNCREATE程序启动就崩报RUNTIME_CLASS相关的断言失败。IsKindOf()也是这套系统的产物用来判断一个对象是否是某个类或其派生类的实例在Serialize反序列化时用得多。4. 动手写第一个能跑的 MFC 程序4.1 在视图里画一个彩色正方形创建完 SDI 工程后找到CXxxView::OnDraw(CDC* pDC)这就是你的画布。先写个最简单的版本void CMfcColorView::OnDraw(CDC* pDC) { CMfcColorDoc* pDoc GetDocument(); ASSERT_VALID(pDoc); if (!pDoc) return; CRect rcClient; GetClientRect(rcClient); // 正方形边长取客户区短边的一半居中 int side min(rcClient.Width(), rcClient.Height()) / 2; if (side 10) side 10; int left (rcClient.Width() - side) / 2; int top (rcClient.Height() - side) / 2; CRect rcSquare(left, top, left side, top side); pDC-FillSolidRect(rcSquare, m_clrFill); CPen pen(PS_SOLID, 2, RGB(80, 80, 80)); CPen* pOldPen pDC-SelectObject(pen); pDC-Rectangle(rcSquare); pDC-SelectObject(pOldPen); }这里的m_clrFill是给文档或视图加的一个COLORREF成员初始化为蓝色。注意一个高频错误CPen pen(...)是栈对象用完必须SelectObject还原否则pen析构时 GDI 对象还在 DC 里被引用会触发资源泄漏断言。如果用new CPen那要记得在合适的地方delete但 GDI 对象和 DC 绑定期间绝对不能删。光标拖动改变窗口大小时画面会闪这是 WM_ERASEBKGND 先刷背景、WM_PAINT 再画内容导致的。解决办法一是给视图类加ON_WM_ERASEBKGND并直接返回 TRUE 表示背景已被处理二是用双缓冲先画到内存 DC 上最后一次性BitBlt到屏幕。// 消息映射里加 ON_WM_ERASEBKGND() // 成员函数 BOOL CMfcColorView::OnEraseBkgnd(CDC* /*pDC*/) { return TRUE; }双缓冲版void CMfcColorView::OnDraw(CDC* pDC) { CRect rcClient; GetClientRect(rcClient); if (rcClient.IsRectEmpty()) return; CDC memDC; memDC.CreateCompatibleDC(pDC); CBitmap bmp; bmp.CreateCompatibleBitmap(pDC, rcClient.Width(), rcClient.Height()); CBitmap* pOldBmp memDC.SelectObject(bmp); memDC.FillSolidRect(rcClient, RGB(255, 255, 255)); int side min(rcClient.Width(), rcClient.Height()) / 2; int left (rcClient.Width() - side) / 2; int top (rcClient.Height() - side) / 2; CRect rcSquare(left, top, left side, top side); memDC.FillSolidRect(rcSquare, m_clrFill); pDC-BitBlt(0, 0, rcClient.Width(), rcClient.Height(), memDC, 0, 0, SRCCOPY); memDC.SelectObject(pOldBmp); }双缓冲的代价是每次重绘都要新建一个兼容位图窗口很大时开销不小。更省的做法是把memDC和bmp做成视图的成员只在窗口尺寸变化OnSize时重建平时复用。4.2 加个菜单命令让颜色可以选光一个固定颜色的方块没意思加个颜色选择。打开资源视图展开Xxx.rc找到IDR_MAINFRAME菜单在帮助菜单左边插一个新顶级菜单项叫颜色下面加一个子项选择颜色把它的 ID 改成ID_COLOR_PICK。然后右键这个菜单项选添加事件处理程序类列表选CMfcColorView消息类型选COMMAND这样类向导会自动往视图的头文件和源文件里写声明和映射宏。写处理函数void CMfcColorView::OnColorPick() { CColorDialog dlg(m_clrFill, CC_FULLOPEN | CC_ANYCOLOR, this); if (dlg.DoModal() IDOK) { m_clrFill dlg.GetColor(); Invalidate(); // 触发重绘参数用 FALSE 可以不擦背景配合双缓冲更顺 } }这里有三点实操心得。第一Invalidate()传TRUE默认会先发WM_ERASEBKGND容易闪如果你已经做了双缓冲 OnEraseBkgnd返回 TRUE用Invalidate(FALSE)更平滑。第二CColorDialog的第二个参数选CC_FULLOPEN会直接展开完整调色板用户少点一次。第三m_clrFill存哪儿很关键存视图里切换文档或新建文档时会丢存文档里配合Serialize就能持久化。这就是文档/视图架构存在的意义一旦你想保存状态就能体会到。4.3 用列表控件展示数据顺便填掉那个对齐的坑CListCtrl是 MFC 里最常用的列表控件。用之前先在对话框或视图上放一个或者直接在视图里创建。关键是要设置LVS_REPORT样式否则列不显示// 视图的 OnCreate 里 m_list.Create(WS_CHILD | WS_VISIBLE | LVS_REPORT | LVS_SINGLESEL, CRect(0, 0, 0, 0), this, IDC_LIST1); m_list.SetExtendedStyle(m_list.GetExtendedStyle() | LVS_EX_FULLROWSELECT | LVS_EX_GRIDLINES);插入列并设置对齐m_list.InsertColumn(0, _T(名称), LVCFMT_LEFT, 160); m_list.InsertColumn(1, _T(数量), LVCFMT_RIGHT, 80); m_list.InsertColumn(2, _T(状态), LVCFMT_CENTER, 100);现在说热词里那个经典问题——VS2010 MFC list 控件第一行设置 LVCFMT_LEFT 无效果。这个现象我碰到过好几次原因基本逃不出下面几种按出现频率排序第一LVCFMT_LEFT本来就是InsertColumn的默认值所以你把默认参数显式写出来看到的当然跟不写一模一样这叫无效果但其实是本来就对。想验证差异你改成LVCFMT_RIGHT或LVCFMT_CENTER就能看出变化。第二你想改的是一个已经插入的列而InsertColumn只能在插入那一刻设定对齐。运行期改对齐必须用LVCOLUMN结构体配合SetColumnLVCOLUMN col { 0 }; col.mask LVCF_FMT; col.fmt LVCFMT_CENTER; m_list.SetColumn(0, col);第三控件没有LVS_REPORT样式列压根不显示谈不上对齐。第四如果控件开了自绘样式LVS_OWNERDRAWFIXED或用了CListCtrl的自绘派生类对齐由你自己的DrawItem/OnDraw控制表头设了也没用。第五列宽太窄文字被截断看起来像没对齐。顺手用SetColumnWidth加宽就能排除。这里还有一个隐藏问题ON_BN_CLICKED这类控件的通知消息如果控件放在视图上而不是对话框里反射机制不生效你得在视图类里处理WM_NOTIFY或者给控件做子类化。这也是新手常见困惑。5. 常见问题与排查技巧实录5.1 编译链接阶段的典型报错MFC 工程最烦的就是一堆链接错误看着莫名其妙。下面这张表是我这些年攒下来的对照表报错信息关键词真实原因解决办法无法打开源文件afxwin.h没装 MFC 组件或项目没启用 MFCInstaller 里勾 MFC 组件项目属性→高级→使用 MFCC1189: Building MFC application with /MD[d] requires...运行库和使用 MFC设置不匹配共享使用 MFC 时必须配 /MD 或 /MDd静态用 MFC 配 /MTLNK2019: 无法解析的外部符号 _WinMain16控制台项目混进了 MFC 入口或字符集与入口点不符检查项目属性→链接器→系统→子系统检查使用 MFC设置C1010: 在查找预编译头时遇到意外的文件结尾新建的 .cpp 第一行没#include pch.h补上或者把该文件的预编译头设成不使用LNK2005: xxx 已经在 xxx.obj 中定义头文件里定义了非 inline 的全局函数或变量加inline或移到 .cpp或加staticC4996: xxx 被声明为已否决用了被标记为不安全的 CRT 函数换安全版本或定义_CRT_SECURE_NO_WARNINGS还有一个高频需求让控制台程序支持 MFC方便在控制台里用CString、CFile这些类做快速验证。步骤是项目属性→高级→使用 MFC→改成在共享 DLL 中使用 MFC在pch.h最顶部一定要在windows.h之前加#include afxwin.h然后在main里手动初始化#include afxwin.h #include tchar.h int _tmain(int argc, TCHAR* argv[]) { if (!AfxWinInit(::GetModuleHandle(NULL), NULL, ::GetCommandLine(), 0)) { _tprintf(_T(MFC 初始化失败\n)); return 1; } CString str; str.Format(_T(当前进程 ID: %lu), GetCurrentProcessId()); _tprintf(_T(%s\n), (LPCTSTR)str); return 0; }注意_tprintf打印CString时必须(LPCTSTR)强转否则参数类型不对输出会是乱码。Unicode 工程下_tprintf对应wprintf普通printf打不出来。5.2 界面与控件的那些坑控件根本不显示多半是没调用InitCommonControlsEx。CListCtrl、CTreeCtrl、CProgressCtrl这些通用控件都属于 comctl32.dllMFC 的CWinApp::InitInstance里其实会自动调但如果你自己写的控制台或者非标准启动流程就得手动加。另外要确认链接了comctl32.lib。想看 CTreeCtrl 源码MFC 的通用控件类绝大多数方法都是内联转发到 Win32 的TreeView_XXX宏上。真正的方法体在atlmfc\src\mfc\afxcmn.inl和afxcmn.h最后都落到 comctl32 的导出函数。所以你在 VS 里按 F12 跳到CTreeCtrl::InsertItem看到的多半是一行内联调用别以为 MFC 又包了一层自己的实现。MFC GridCtrl 单元格配色这个是第三方控件Chris Maunder 的 MFC Grid Control不是 MFC 自带的。给单元格上色用SetItemBkColour(row, col, RGB(...))和SetItemFgColour然后Refresh()。想在某个单元格里嵌一个颜色选择控件并显示选定的配色线条我的建议是别硬嵌子窗口——滚动、重定位、销毁时序都得自己管成本很高。常见做法是双击单元格时弹CColorDialog选完把颜色值存进该单元格的ItemData然后在OnDrawCell里自己画一条色带表示选定颜色。这样逻辑简单视觉上也直观。工业上位机那类界面像流量计读数面板这种本质就是一堆CStatic标签CEdit数值 自绘进度条或仪表盘控件的组合。仪表盘的画法跟 4.1 的彩色正方形是同一套思路只是把Rectangle换成Pie、Arc、Polygon这些 GDI 绘图函数再配上定时器刷新。5.3 线程与第三方库混用MFC 里创建线程有两个入口都在AfxBeginThread但参数不同用途也不同工作者线程Worker ThreadAfxBeginThread(ThreadProc, pParam)没有消息循环适合后台计算、文件 IO、串口收数据。界面线程UI ThreadAfxBeginThread(RUNTIME_CLASS(CMyThread))CMyThread从CWinThread派生有独立消息循环能创建窗口。最容易出事的是跨线程访问界面。工作者线程里绝对不能直接调用控件的SetWindowText或UpdateData会随机崩溃。正确做法是用PostMessage把结果发回主线程在主线程的消息处理函数里更新界面// 工作者线程里 ::PostMessage(hMainWnd, WM_USER_DATA_READY, (WPARAM)nValue, 0); // 主线程消息映射里 ON_MESSAGE(WM_USER_DATA_READY, CMainFrame::OnDataReady) LRESULT CMainFrame::OnDataReady(WPARAM wParam, LPARAM /*lParam*/) { m_editValue.SetWindowText(...); return 0; }线程退出时注意CWinThread的m_bAutoDelete默认是 TRUE对象会自己 delete别手动删。用WaitForSingleObject等线程句柄时先DuplicateHandle或者设m_bAutoDelete FALSE否则句柄可能已经无效。集成 zxing-cpp 做二维码识别这个需求一般是读取图片里的二维码。思路是把 zxing-cpp 编译成静态库MFC 工程里加 include 目录和 lib 依赖图片加载用CImage或ATL::CImage取出像素数据丢给 zxing 的ReadBarcode。这里有两个坑一是 MFC 默认 Unicodezxing 返回的std::string是 UTF-8要转成CString必须用MultiByteToWideChar(CP_UTF8, ...)直接用CString(str.c_str())会乱码二是静态链接 zxing 时注意和 MFC 的运行库设置保持一致一个 /MT 一个 /MD 就会链接失败。6. 我个人的几点实操心得先说一个能大幅提升调试效率的技巧把断点打在CWnd::WindowProc或者AfxWndProc上观察消息流。界面问题很多时候是消息没走到、或者走错对象打在这里能一次性看清楚消息号、目标窗口句柄、处理结果。配合 SpyVS 菜单工具→Spy看窗口层级找明明创建了控件却收不到通知这类问题几乎百发百中。第二条别急着上第三方控件。新手常见的心态是一上来就找各种好看的自绘控件库结果基础控件都没玩明白出问题了分不清是库的问题还是自己用法的问题。CListCtrl、CTreeCtrl、CEdit、CComboBox这几个先吃透尤其是CComboBox的CBS_DROPDOWN和CBS_DROPDOWNLIST的区别、SetCurSel和SelectString的差别踩一次就记住了。第三条消息映射宏建议手写。类向导虽然方便但它生成的代码把声明和实现分在两个文件里改起来要在两个文件之间跳而且一旦你在向导里改了类名或 ID残留的旧映射有时清不掉。我现在的习惯是向导只用来生成资源 ID 和初始骨架后面加消息一律自己在.h里写afx_msg声明在.cpp的BEGIN_MESSAGE_MAP块里手写ON_WM_XXX出错了编译直接报定位比向导的默默失效好得多。第四条老工程从 VS2010 升级到 VS2019/2022 时的重点。主要是三处平台工具集从 v100 提到 v142/v143targetver.h里的_WIN32_WINNT要跟着改MFC 库版本升级后一些废弃的 API 会报警告以及 64 位编译打开的坑——long在不同平台宽度不同老代码里大量把指针强转成long的地方在 x64 下会截断务必换成LONG_PTR或INT_PTR。升级前先建个分支别在原工程上直接动。最后分享一个小习惯我每建一个新 MFC 工程都会先在InitInstance里加一行日志输出把程序启动的关键节点加载资源、创建窗口、进入消息循环打出来方便后面对照 3.1 那条启动链路。等你哪天遇到程序启动一半就没了的问题这行日志能省你半天时间。下一篇笔记我打算拆消息映射的完整实现细节和自定义消息包括自己定义WM_USER范围消息、用ON_MESSAGE收发的写法感兴趣可以先自己试着写一个。
搞 Windows 桌面端开发的人绕不开 MFC 这三个字母。哪怕你平时主力写的是 Qt、WPF 或者别的什么框架只要接手过一些年头比较久的工业上位机、仪器仪表配套软件、行业内部工具十有八九会在源码目录里看到一对.h/.cpp里面全是C打头的类名和一堆ON_WM_XXX宏。MFCMicrosoft Foundation Class是微软在九十年代初推出的 C 类库把 Win32 API 用面向对象的方式薄薄包了一层顺手把窗口注册、消息循环、文档数据管理这些脏活累活都兜住了。这组笔记我打算从零捋一遍第一篇先把三件事说透它是什么、工程怎么建、代码到底是怎么跑起来的。如果你是完全没碰过 MFC 的新手或者以前跟着教程敲过一遍但始终没搞明白向导生成的那堆文件谁调用谁这篇应该能帮你把地基打上。环境我用 VS2019 和 VS2022 为主老版本比如 VS2010的差异我会单独标出来。1. 先搞清楚 MFC 到底是个什么东西1.1 它解决的是哪个年代的什么痛点要理解 MFC 为什么长成这样得先回到没有它的年代。Windows 3.x 时期写一个窗口程序标准流程是定义 WNDCLASS、调用 RegisterClass、CreateWindow、ShowWindow、UpdateWindow然后写一个巨大的 WndProc里面一个switch(msg)接住WM_CREATE、WM_PAINT、WM_SIZE、WM_COMMAND等几十上百种消息每个分支还得自己处理句柄转换、参数拆包、GDI 对象申请和释放。一个带菜单、能响应按钮点击的Hello World纯 Win32 API 写下来一百多行是起步价而且所有窗口的 WndProc 长得都差不多属于纯粹的重复劳动。MFC 的核心思路就是把这些重复模式抽象成类。CWnd封装HWNDCWinApp封装整个应用程序实例CDC封装HDCCGdiObject及其派生类封装各种 GDI 对象。最关键的改动是消息处理不再写巨型 switch而是用一组宏把你的处理函数登记到一张表里运行时按消息查表调用。这套机制叫消息映射是 MFC 区别于普通 Win32 封装库的分水岭也是后面第 3 章要重点拆的东西。1.2 MFC 和 Win32 API、Qt、WinForms 摆一起怎么选很多新手会问现在学 MFC 还有没有意义。我的看法是把它当成一门维护技能和底层理解工具而不是新项目首选。下面这张表是我自己选型时会过的几个维度供你参考维度原生 Win32 APIMFCQt.NET WinForms/WPF开发语言CCC / QMLC# / VB.NET封装程度无薄封装几乎能穿透到底层自绘控件体系跨平台托管封装跨语言学习曲线陡中等坑在文档少中等偏缓平缓界面现代化要自己画要自己画或用第三方库开箱好看开箱好看部署依赖无VC 运行库静态链接可免Qt 运行库.NET 运行时现存老项目数量多非常多多多调试便利性好好和 VS 深度集成一般好MFC 真正的优势在于生成的是原生控件程序体积小不依赖额外的运行时框架可以直接插 Win32 API 调用跟 Visual Studio 的调试器、资源编辑器、类向导贴合得极深。劣势也很明显界面风格停留在上个时代自带控件数量少没有真正的布局管理器要手动算坐标或者用第三方官方文档更新频率极低。至于那些把 MFC 说成过时垃圾的论调我的态度是——技术选型看场景接手一个几十万行的 MFC 老项目时能读懂BEGIN_MESSAGE_MAP比会写 React 有用得多。1.3 学 MFC 之前你得先有点什么底子不用等到 C 精通但下面这几样必须过关否则后面全是玄学。第一是类和继承MFC 里几乎所有对象都从CObject派生虚函数覆盖是家常便饭第二是Windows 消息机制的基本概念知道什么是窗口句柄、消息队列、PostMessage和SendMessage的区别第三是句柄类型HWND、HDC、HINSTANCE、HANDLE这些别搞混MFC 里GetSafeHwnd()这类函数到处都是第四也是新手最容易栽的字符集的坑。MFC 从 VS2005 起默认用 Unicode宽字符TCHAR、_T()、L、CString的行为和你在控制台里写char*的习惯完全不同很多编译报错都是这里来的。2. 开发环境准备与工程创建全流程2.1 VS 版本挑哪个安装时别漏了什么先解决一个经典问题为什么我新建项目时在模板列表里搜不到MFC 应用答案几乎只有一个——装 VS 的时候没勾 MFC 组件。打开 Visual Studio Installer找到你装的那个版本点修改在工作负载页确认勾选了使用 C 的桌面开发然后在右侧的安装详细信息里往下翻找到适用于最新 v143 生成工具的 C MFCx86 和 x64这一项勾上点右下角修改。装完重启 VS模板就出来了。VS2019 和 VS2022 的操作完全一样只是平台工具集版本号不同。如果你还在用 VS2010那不用额外装MFC 是随 IDE 一起带的但要注意 VS2010 默认的 MFC 版本和现在的差异较大部分CMFCxxx开头的类在 VS2010 上是不存在的比如CMFCButton、CMFCColorButton这些是 VS2008 SP1 的 Feature Pack 才引入VS2010 有但更早的没有。另外提醒一句安装 MFC 组件会占大概 1 到 2 GB 磁盘空间如果你的 C 盘紧张可以只勾 x64 版本x86 那半边不装也能跑只是将来打包 32 位程序时得补上。2.2 向导里的每一页该怎么选新建项目选MFC 应用输入项目名点确定就进入 MFC 应用程序向导。这个向导一共六七页我按重要程度排一下把每页的实际含义讲清楚第一页应用程序类型是整份向导里最重要的一个选择单个文档SDI程序一次只能打开一个文档像记事本。适合大多数数据查看类工具。多个文档MDI一个主窗口里能开多个子窗口像老版 Photoshop。适合同时操作多份数据的场景。基于对话框整个程序就是一个对话框没有菜单栏和状态栏。适合配置工具、小计算器这类没有文档概念的软件。新手我强烈建议从这个类型起步因为它的代码最少、结构最直白。多个顶级文档每个文档一个独立顶层窗口类似现代浏览器那种多窗口模式。下面还有一个项目样式下拉选Visual Studio会生成带停靠窗格、属性页、现代外观的界面选MFC 标准则是最朴素的老样式。新手选 MFC 标准代码干净好读。第二页复合文档支持除非你要做 OLE 嵌入比如在文档里嵌 Excel 表格一律选无。第三页文档模板字符串这里填三个值标题程序窗口标题栏显示的文字、文件扩展名、以及资源 ID。文件扩展名会跟文件-打开/保存绑定如果你做的是 SDI 记事本类程序就填txt。第四页数据库支持选无。MFC 自带的那套 ODBC 数据库封装CRecordset已经是老古董了真要连数据库不如直接用新的库。第五页用户界面功能有几个勾功能区、经典菜单、工具栏、停靠窗格、状态栏。如果你就是想看最传统的界面取消功能区勾上经典菜单和工具栏。第六页高级功能一堆东西上下文相关帮助、打印和打印预览、自动化、ActiveX 控件、MAPI、Windows 套接字、以及一个 CRT 头文件选项。这里按需勾一般保留打印和打印预览就行。最后一页生成的类会列出向导准备生成的类名和基类。新手在这一页可以顺手改项目前缀比如把CMfcApplication1App改成CMainApp省得后面一个个改名。2.3 向导生成的文件清单逐个拆解以单个文档 MFC 标准样式为例向导会给你生成下面这一套东西我按调用顺序和重要性排一下文件作用你需要改它的频率pch.h/stdafx.h预编译头把所有公共头文件塞这里极低framework.h框架相关的公共包含低targetver.h指定目标 Windows 最低版本升 VS 时看一眼XxxApp.h/.cpp应用程序类从CWinApp派生中MainFrm.h/.cpp主框架窗口从CFrameWnd派生高XxxDoc.h/.cpp文档类从CDocument派生高XxxView.h/.cpp视图类从CView派生最高Xxx.rc资源脚本菜单、图标、字符串都在里面高resource.h资源的 ID 宏定义中res\目录图标、位图等二进制资源低需要特别注意pch.h的用法每个.cpp文件的第一行注释之外必须是#include pch.h否则会报C1010: 在查找预编译头时遇到意外的文件结尾。这个坑新手百分百会踩因为手动新建的.cpp文件默认没有这行。3. MFC 核心运行机制拆解3.1 从 WinMain 到 InitInstance程序到底是怎么启动的问题的关键来了打开向导生成的工程搜索WinMain你会发现根本搜不到可程序明明能跑起来。原因在于MFC 自己提供了一个 WinMain藏在appmodul.cpp这个文件里源码位置大概在VS安装目录\VC\Tools\MSVC\版本号\atlmfc\src\mfc\appmodul.cpp。它的完整启动链路是这样的你在XxxApp.cpp里写了CXxxApp theApp;这个全局对象。C 保证全局对象在main之前构造它的构造函数里会把自己的this指针存到 MFC 的全局变量afxCurrentWinApp。CRT 启动后链接器把入口点指向 MFC 的_tWinMain在appmodul.cpp里而不是你自己写的 main。_tWinMain调用AfxWinMain后者依次执行AfxWinInit初始化模块状态、加载资源句柄、处理命令行→pApp-InitApplication()→pApp-InitInstance()。InitInstance是你唯一需要自己写的启动逻辑向导已经帮你填好了骨架构造文档模板、解析命令行、创建主框架窗口、ShowWindow(SW_SHOW)、UpdateWindow()。回到AfxWinMain调用pApp-Run()进入消息循环GetMessage/TranslateMessage/DispatchMessage。消息循环退出后调用pApp-ExitInstance()然后清理收尾。理解这条链路的最大价值是当你在InitInstance里做了什么马上就能对应上程序刚启动的那一刻。比如你想在程序启动时读一个配置文件正确位置就是InitInstance里ShowWindow之前想等窗口显示后再做就放到MainFrm::OnCreate或视图的OnInitialUpdate里。3.2 消息映射MFC 是怎么把巨型 WndProc 拆散的传统 Win32 的消息处理长这样LRESULT CALLBACK WndProc(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam) { switch (msg) { case WM_PAINT: // 绘制 break; case WM_LBUTTONDOWN: // 响应点击 break; case WM_COMMAND: // 处理菜单和按钮 break; default: return DefWindowProc(hWnd, msg, wParam, lParam); } return 0; }MFC 把它拆成了消息映射表 成员函数。你在类里写三个宏// 头文件里 class CMainFrame : public CFrameWnd { DECLARE_MESSAGE_MAP() public: afx_msg void OnPaint(); afx_msg void OnLButtonDown(UINT nFlags, CPoint point); afx_msg void OnFileNew(); }; // 源文件里 BEGIN_MESSAGE_MAP(CMainFrame, CFrameWnd) ON_WM_PAINT() ON_WM_LBUTTONDOWN() ON_COMMAND(ID_FILE_NEW, CMainFrame::OnFileNew) END_MESSAGE_MAP()展开之后BEGIN_MESSAGE_MAP定义了一个静态的AFX_MSGMAP_ENTRY结构体数组每条ON_WM_XXX就是数组里的一行记录消息号、控件 ID、处理函数签名、函数指针这几样东西。同时它定义了两个静态函数GetThisMessageMap()返回这张表GetMessageMap()是虚函数返回当前对象的表。数组最后一项是空的哨兵并且通过pBaseMap指向父类的表。运行时系统回调AfxWndProcMFC 的全局窗口过程它做两件事先通过CWnd::FromHandlePermanent把HWND还原成 C 对象的this指针然后调用this-WindowProc。WindowProc内部走OnWndMsg去查当前类的消息映射表没找到就沿着pBaseMap链往上找这就是为什么子类能覆盖父类的消息处理一路找到顶层都没有才落到DefWindowProc。这里有个常被忽略的细节OnWndMsg先查WM_COMMAND和WM_NOTIFY这类反射消息再查普通消息。所以如果你给按钮的处理函数没被调用第一件事就是确认按钮的 ID 和ON_BN_CLICKED(IDC_BUTTON1, ...)里的 ID 一致第二件事确认这个按钮是当前窗口的子控件否则要在父窗口处理。3.3 文档/视图架构到底解决了什么问题MFC 的文档/视图Document/View架构由四个角色组成CDocument管数据CView管显示和用户交互CFrameWnd提供外框菜单、工具栏、状态栏挂在这里CDocTemplate是胶水把前三者绑成一个文档类型。SDI 用CSingleDocTemplateMDI 用CMultiDocTemplate。它想解决的问题是数据与显示分离。一个CDocument可以挂多个CView比如同一份销售数据左边用一个表格视图显示清单右边用曲线视图显示趋势两个视图共享同一份数据对象。修改数据后文档调用UpdateAllViews()所有挂在上面的视图收到通知并重绘。这个模式在数据可视化类软件里非常有效。第二个好处是免费获得文件读写。CDocument有一个虚函数Serialize(CArchive ar)你只要在里面把成员变量按顺序流进流出框架就帮你把文件-打开文件-保存另存为全部串好了void CMyDoc::Serialize(CArchive ar) { if (ar.IsStoring()) { ar m_nValue m_strName; } else { ar m_nValue m_strName; } }代价是对小工具来说这是过度设计。如果你只是写一个串口调试助手或者配置对话框用基于对话框类型能省掉文档类、视图类、文档模板这一整坨东西。我见过不少人硬套 SDI 去写工具软件结果在OnDraw和UpdateAllViews之间来回绕反而更乱。3.4 运行时类型信息与动态创建MFC 早于 C 标准 RTTI 出现所以它自造了一套运行时类型系统核心是CRuntimeClass结构体里面存着类名、对象大小、以及一个指向基类的指针。你在类里写DECLARE_DYNAMIC(CMainFrame)在源文件里写IMPLEMENT_DYNAMIC(CMainFrame, CFrameWnd)MFC 就会为这个类生成一个静态的CRuntimeClass对象并把RUNTIME_CLASS(CMainFrame)变成取这个对象的宏。这套东西的实用价值是动态创建用DECLARE_DYNCREATE/IMPLEMENT_DYNCREATE声明的类可以通过CRuntimeClass::CreateObject()在运行时按名字创建对象。文档模板就是这样创建文档、视图、框架的——框架启动时并不知道具体要创建哪个类只有文档模板里存的一个CRuntimeClass*指针靠它才把对象造出来。所以如果你删掉或改名了某个IMPLEMENT_DYNCREATE程序启动就崩报RUNTIME_CLASS相关的断言失败。IsKindOf()也是这套系统的产物用来判断一个对象是否是某个类或其派生类的实例在Serialize反序列化时用得多。4. 动手写第一个能跑的 MFC 程序4.1 在视图里画一个彩色正方形创建完 SDI 工程后找到CXxxView::OnDraw(CDC* pDC)这就是你的画布。先写个最简单的版本void CMfcColorView::OnDraw(CDC* pDC) { CMfcColorDoc* pDoc GetDocument(); ASSERT_VALID(pDoc); if (!pDoc) return; CRect rcClient; GetClientRect(rcClient); // 正方形边长取客户区短边的一半居中 int side min(rcClient.Width(), rcClient.Height()) / 2; if (side 10) side 10; int left (rcClient.Width() - side) / 2; int top (rcClient.Height() - side) / 2; CRect rcSquare(left, top, left side, top side); pDC-FillSolidRect(rcSquare, m_clrFill); CPen pen(PS_SOLID, 2, RGB(80, 80, 80)); CPen* pOldPen pDC-SelectObject(pen); pDC-Rectangle(rcSquare); pDC-SelectObject(pOldPen); }这里的m_clrFill是给文档或视图加的一个COLORREF成员初始化为蓝色。注意一个高频错误CPen pen(...)是栈对象用完必须SelectObject还原否则pen析构时 GDI 对象还在 DC 里被引用会触发资源泄漏断言。如果用new CPen那要记得在合适的地方delete但 GDI 对象和 DC 绑定期间绝对不能删。光标拖动改变窗口大小时画面会闪这是 WM_ERASEBKGND 先刷背景、WM_PAINT 再画内容导致的。解决办法一是给视图类加ON_WM_ERASEBKGND并直接返回 TRUE 表示背景已被处理二是用双缓冲先画到内存 DC 上最后一次性BitBlt到屏幕。// 消息映射里加 ON_WM_ERASEBKGND() // 成员函数 BOOL CMfcColorView::OnEraseBkgnd(CDC* /*pDC*/) { return TRUE; }双缓冲版void CMfcColorView::OnDraw(CDC* pDC) { CRect rcClient; GetClientRect(rcClient); if (rcClient.IsRectEmpty()) return; CDC memDC; memDC.CreateCompatibleDC(pDC); CBitmap bmp; bmp.CreateCompatibleBitmap(pDC, rcClient.Width(), rcClient.Height()); CBitmap* pOldBmp memDC.SelectObject(bmp); memDC.FillSolidRect(rcClient, RGB(255, 255, 255)); int side min(rcClient.Width(), rcClient.Height()) / 2; int left (rcClient.Width() - side) / 2; int top (rcClient.Height() - side) / 2; CRect rcSquare(left, top, left side, top side); memDC.FillSolidRect(rcSquare, m_clrFill); pDC-BitBlt(0, 0, rcClient.Width(), rcClient.Height(), memDC, 0, 0, SRCCOPY); memDC.SelectObject(pOldBmp); }双缓冲的代价是每次重绘都要新建一个兼容位图窗口很大时开销不小。更省的做法是把memDC和bmp做成视图的成员只在窗口尺寸变化OnSize时重建平时复用。4.2 加个菜单命令让颜色可以选光一个固定颜色的方块没意思加个颜色选择。打开资源视图展开Xxx.rc找到IDR_MAINFRAME菜单在帮助菜单左边插一个新顶级菜单项叫颜色下面加一个子项选择颜色把它的 ID 改成ID_COLOR_PICK。然后右键这个菜单项选添加事件处理程序类列表选CMfcColorView消息类型选COMMAND这样类向导会自动往视图的头文件和源文件里写声明和映射宏。写处理函数void CMfcColorView::OnColorPick() { CColorDialog dlg(m_clrFill, CC_FULLOPEN | CC_ANYCOLOR, this); if (dlg.DoModal() IDOK) { m_clrFill dlg.GetColor(); Invalidate(); // 触发重绘参数用 FALSE 可以不擦背景配合双缓冲更顺 } }这里有三点实操心得。第一Invalidate()传TRUE默认会先发WM_ERASEBKGND容易闪如果你已经做了双缓冲 OnEraseBkgnd返回 TRUE用Invalidate(FALSE)更平滑。第二CColorDialog的第二个参数选CC_FULLOPEN会直接展开完整调色板用户少点一次。第三m_clrFill存哪儿很关键存视图里切换文档或新建文档时会丢存文档里配合Serialize就能持久化。这就是文档/视图架构存在的意义一旦你想保存状态就能体会到。4.3 用列表控件展示数据顺便填掉那个对齐的坑CListCtrl是 MFC 里最常用的列表控件。用之前先在对话框或视图上放一个或者直接在视图里创建。关键是要设置LVS_REPORT样式否则列不显示// 视图的 OnCreate 里 m_list.Create(WS_CHILD | WS_VISIBLE | LVS_REPORT | LVS_SINGLESEL, CRect(0, 0, 0, 0), this, IDC_LIST1); m_list.SetExtendedStyle(m_list.GetExtendedStyle() | LVS_EX_FULLROWSELECT | LVS_EX_GRIDLINES);插入列并设置对齐m_list.InsertColumn(0, _T(名称), LVCFMT_LEFT, 160); m_list.InsertColumn(1, _T(数量), LVCFMT_RIGHT, 80); m_list.InsertColumn(2, _T(状态), LVCFMT_CENTER, 100);现在说热词里那个经典问题——VS2010 MFC list 控件第一行设置 LVCFMT_LEFT 无效果。这个现象我碰到过好几次原因基本逃不出下面几种按出现频率排序第一LVCFMT_LEFT本来就是InsertColumn的默认值所以你把默认参数显式写出来看到的当然跟不写一模一样这叫无效果但其实是本来就对。想验证差异你改成LVCFMT_RIGHT或LVCFMT_CENTER就能看出变化。第二你想改的是一个已经插入的列而InsertColumn只能在插入那一刻设定对齐。运行期改对齐必须用LVCOLUMN结构体配合SetColumnLVCOLUMN col { 0 }; col.mask LVCF_FMT; col.fmt LVCFMT_CENTER; m_list.SetColumn(0, col);第三控件没有LVS_REPORT样式列压根不显示谈不上对齐。第四如果控件开了自绘样式LVS_OWNERDRAWFIXED或用了CListCtrl的自绘派生类对齐由你自己的DrawItem/OnDraw控制表头设了也没用。第五列宽太窄文字被截断看起来像没对齐。顺手用SetColumnWidth加宽就能排除。这里还有一个隐藏问题ON_BN_CLICKED这类控件的通知消息如果控件放在视图上而不是对话框里反射机制不生效你得在视图类里处理WM_NOTIFY或者给控件做子类化。这也是新手常见困惑。5. 常见问题与排查技巧实录5.1 编译链接阶段的典型报错MFC 工程最烦的就是一堆链接错误看着莫名其妙。下面这张表是我这些年攒下来的对照表报错信息关键词真实原因解决办法无法打开源文件afxwin.h没装 MFC 组件或项目没启用 MFCInstaller 里勾 MFC 组件项目属性→高级→使用 MFCC1189: Building MFC application with /MD[d] requires...运行库和使用 MFC设置不匹配共享使用 MFC 时必须配 /MD 或 /MDd静态用 MFC 配 /MTLNK2019: 无法解析的外部符号 _WinMain16控制台项目混进了 MFC 入口或字符集与入口点不符检查项目属性→链接器→系统→子系统检查使用 MFC设置C1010: 在查找预编译头时遇到意外的文件结尾新建的 .cpp 第一行没#include pch.h补上或者把该文件的预编译头设成不使用LNK2005: xxx 已经在 xxx.obj 中定义头文件里定义了非 inline 的全局函数或变量加inline或移到 .cpp或加staticC4996: xxx 被声明为已否决用了被标记为不安全的 CRT 函数换安全版本或定义_CRT_SECURE_NO_WARNINGS还有一个高频需求让控制台程序支持 MFC方便在控制台里用CString、CFile这些类做快速验证。步骤是项目属性→高级→使用 MFC→改成在共享 DLL 中使用 MFC在pch.h最顶部一定要在windows.h之前加#include afxwin.h然后在main里手动初始化#include afxwin.h #include tchar.h int _tmain(int argc, TCHAR* argv[]) { if (!AfxWinInit(::GetModuleHandle(NULL), NULL, ::GetCommandLine(), 0)) { _tprintf(_T(MFC 初始化失败\n)); return 1; } CString str; str.Format(_T(当前进程 ID: %lu), GetCurrentProcessId()); _tprintf(_T(%s\n), (LPCTSTR)str); return 0; }注意_tprintf打印CString时必须(LPCTSTR)强转否则参数类型不对输出会是乱码。Unicode 工程下_tprintf对应wprintf普通printf打不出来。5.2 界面与控件的那些坑控件根本不显示多半是没调用InitCommonControlsEx。CListCtrl、CTreeCtrl、CProgressCtrl这些通用控件都属于 comctl32.dllMFC 的CWinApp::InitInstance里其实会自动调但如果你自己写的控制台或者非标准启动流程就得手动加。另外要确认链接了comctl32.lib。想看 CTreeCtrl 源码MFC 的通用控件类绝大多数方法都是内联转发到 Win32 的TreeView_XXX宏上。真正的方法体在atlmfc\src\mfc\afxcmn.inl和afxcmn.h最后都落到 comctl32 的导出函数。所以你在 VS 里按 F12 跳到CTreeCtrl::InsertItem看到的多半是一行内联调用别以为 MFC 又包了一层自己的实现。MFC GridCtrl 单元格配色这个是第三方控件Chris Maunder 的 MFC Grid Control不是 MFC 自带的。给单元格上色用SetItemBkColour(row, col, RGB(...))和SetItemFgColour然后Refresh()。想在某个单元格里嵌一个颜色选择控件并显示选定的配色线条我的建议是别硬嵌子窗口——滚动、重定位、销毁时序都得自己管成本很高。常见做法是双击单元格时弹CColorDialog选完把颜色值存进该单元格的ItemData然后在OnDrawCell里自己画一条色带表示选定颜色。这样逻辑简单视觉上也直观。工业上位机那类界面像流量计读数面板这种本质就是一堆CStatic标签CEdit数值 自绘进度条或仪表盘控件的组合。仪表盘的画法跟 4.1 的彩色正方形是同一套思路只是把Rectangle换成Pie、Arc、Polygon这些 GDI 绘图函数再配上定时器刷新。5.3 线程与第三方库混用MFC 里创建线程有两个入口都在AfxBeginThread但参数不同用途也不同工作者线程Worker ThreadAfxBeginThread(ThreadProc, pParam)没有消息循环适合后台计算、文件 IO、串口收数据。界面线程UI ThreadAfxBeginThread(RUNTIME_CLASS(CMyThread))CMyThread从CWinThread派生有独立消息循环能创建窗口。最容易出事的是跨线程访问界面。工作者线程里绝对不能直接调用控件的SetWindowText或UpdateData会随机崩溃。正确做法是用PostMessage把结果发回主线程在主线程的消息处理函数里更新界面// 工作者线程里 ::PostMessage(hMainWnd, WM_USER_DATA_READY, (WPARAM)nValue, 0); // 主线程消息映射里 ON_MESSAGE(WM_USER_DATA_READY, CMainFrame::OnDataReady) LRESULT CMainFrame::OnDataReady(WPARAM wParam, LPARAM /*lParam*/) { m_editValue.SetWindowText(...); return 0; }线程退出时注意CWinThread的m_bAutoDelete默认是 TRUE对象会自己 delete别手动删。用WaitForSingleObject等线程句柄时先DuplicateHandle或者设m_bAutoDelete FALSE否则句柄可能已经无效。集成 zxing-cpp 做二维码识别这个需求一般是读取图片里的二维码。思路是把 zxing-cpp 编译成静态库MFC 工程里加 include 目录和 lib 依赖图片加载用CImage或ATL::CImage取出像素数据丢给 zxing 的ReadBarcode。这里有两个坑一是 MFC 默认 Unicodezxing 返回的std::string是 UTF-8要转成CString必须用MultiByteToWideChar(CP_UTF8, ...)直接用CString(str.c_str())会乱码二是静态链接 zxing 时注意和 MFC 的运行库设置保持一致一个 /MT 一个 /MD 就会链接失败。6. 我个人的几点实操心得先说一个能大幅提升调试效率的技巧把断点打在CWnd::WindowProc或者AfxWndProc上观察消息流。界面问题很多时候是消息没走到、或者走错对象打在这里能一次性看清楚消息号、目标窗口句柄、处理结果。配合 SpyVS 菜单工具→Spy看窗口层级找明明创建了控件却收不到通知这类问题几乎百发百中。第二条别急着上第三方控件。新手常见的心态是一上来就找各种好看的自绘控件库结果基础控件都没玩明白出问题了分不清是库的问题还是自己用法的问题。CListCtrl、CTreeCtrl、CEdit、CComboBox这几个先吃透尤其是CComboBox的CBS_DROPDOWN和CBS_DROPDOWNLIST的区别、SetCurSel和SelectString的差别踩一次就记住了。第三条消息映射宏建议手写。类向导虽然方便但它生成的代码把声明和实现分在两个文件里改起来要在两个文件之间跳而且一旦你在向导里改了类名或 ID残留的旧映射有时清不掉。我现在的习惯是向导只用来生成资源 ID 和初始骨架后面加消息一律自己在.h里写afx_msg声明在.cpp的BEGIN_MESSAGE_MAP块里手写ON_WM_XXX出错了编译直接报定位比向导的默默失效好得多。第四条老工程从 VS2010 升级到 VS2019/2022 时的重点。主要是三处平台工具集从 v100 提到 v142/v143targetver.h里的_WIN32_WINNT要跟着改MFC 库版本升级后一些废弃的 API 会报警告以及 64 位编译打开的坑——long在不同平台宽度不同老代码里大量把指针强转成long的地方在 x64 下会截断务必换成LONG_PTR或INT_PTR。升级前先建个分支别在原工程上直接动。最后分享一个小习惯我每建一个新 MFC 工程都会先在InitInstance里加一行日志输出把程序启动的关键节点加载资源、创建窗口、进入消息循环打出来方便后面对照 3.1 那条启动链路。等你哪天遇到程序启动一半就没了的问题这行日志能省你半天时间。下一篇笔记我打算拆消息映射的完整实现细节和自定义消息包括自己定义WM_USER范围消息、用ON_MESSAGE收发的写法感兴趣可以先自己试着写一个。
