MFC实战：从零构建Windows记事本，掌握桌面开发核心

发布时间：2026/7/22 5:38:25

1. 项目概述：为什么选择MFC来写一个记事本？

如果你是一个有一定C++基础，但主要停留在控制台程序或者标准库层面的开发者，想迈入Windows桌面应用开发的大门，那么“用MFC写一个记事本”这个项目，绝对是一个教科书级的起点。很多人可能会问，现在有Qt、有WinUI 3、有各种跨平台框架，为什么还要学看起来“古老”的MFC？我的回答是：MFC是理解Windows桌面应用开发“底层逻辑”和“历史包袱”的最佳窗口。它直接封装了Win32 API，让你在享受一定便利性的同时，必须直面消息循环、窗口过程、资源管理这些核心概念。通过完成一个功能完整的记事本，你不仅能掌握MFC的基本使用，更能深刻理解一个Windows GUI程序是如何从无到有、如何响应用户操作、如何管理数据和界面的。这比直接使用更现代的框架，能打下更坚实的地基。

这个实战项目，我们将从零开始，使用Visual Studio 2022，基于MFC的“文档/视图”架构，打造一个具备新建、打开、保存、编辑、查找等核心功能的记事本。我会带你避开我当年踩过的坑，比如文档序列化的陷阱、视图更新的时机、以及如何优雅地处理多字节与Unicode编码。这不仅仅是一个功能实现，更是一次对经典桌面应用开发范式的深度剖析。

2. 开发环境搭建与项目创建

2.1 Visual Studio 2022与MFC的安装要点

工欲善其事，必先利其器。首先确保你安装了Visual Studio 2022。在安装时，“使用C++的桌面开发”这个工作负载是必须勾选的。但仅仅这样还不够，MFC默认可能并未包含。你需要点击这个工作负载右侧的“修改”按钮，在右侧的“安装详细信息”中，找到并勾选“用于x86和x64的MFC”以及“适用于最新v143生成工具的C++ MFC”。这一步非常关键，漏了就会在创建项目时找不到MFC模板。

注意：如果你的项目将来可能需要支持较旧的Windows系统（如Win7），可能需要额外勾选“对v142生成工具的MFC支持”，但新项目通常直接使用最新的v143工具集即可。

安装完成后，启动Visual Studio 2022，点击“创建新项目”。在搜索框输入“MFC”，选择“MFC应用”这个模板。这里有个小技巧：模板列表里可能还有“MFC ActiveX控件”等，别选错了。项目名称我们定为MyNotepad，位置按自己习惯选择。

2.2 应用程序类型与项目配置详解

点击“创建”后，会进入“MFC应用程序向导”。这里是整个项目的骨架定义阶段，每一步的选择都直接影响后续的代码结构。

应用程序类型：
- 单个文档：我们选择“单个文档(SDI)”。记事本一次通常只编辑一个文件，SDI结构更简单直接。多文档(MDI)适合像Visual Studio本身这样的IDE。
- 项目样式：选择“Visual Studio”风格即可，它提供了更现代的界面外观。
- 文档/视图结构支持：务必勾选。这是MVC模式在MFC中的体现，是MFC的精髓之一，能很好地将数据（文档）和显示（视图）分离。我们的记事本内容（文本数据）将由文档类管理，而显示和编辑则在视图类中完成。
复合文档支持：不需要，全部选择“无”。记事本不涉及OLE嵌入链接。
文档模板属性：
- 文件扩展名：这里我们可以填“txt”。这会影响“打开”和“保存”对话框的默认过滤器。
- 文档类型名称：填写“文本文档”。这个名称会出现在窗口标题栏等处。
数据库支持：不需要，选择“无”。
用户界面功能：
- 这里保持默认即可，工具栏、状态栏、菜单栏都是我们需要的。可以勾选“初始状态栏”和“初始工具栏”。
- “使用经典菜单”建议取消勾选，使用新的菜单风格。
高级功能：
- “打印和打印预览”：可以勾选上，虽然我们可能不实现复杂的打印，但MFC框架提供了基础支持，勾选后会自动生成相关菜单和代码框架。
- “ActiveX控件”：不需要。
- “公共控件清单”：保持默认启用，以确保使用正确版本的ComCtl32.dll，让控件有现代外观。
生成的类：这是最后也是最重要的一步。向导会列出即将生成的四个核心类：
- CMyNotepadApp: 派生自CWinAppEx，代表应用程序本身，全局唯一。
- CMainFrame: 派生自CFrameWndEx，是主框架窗口，管理菜单、工具栏、状态栏。
- CMyNotepadDoc: 派生自CDocument，是我们的文档类，负责保存记事本的文本内容。
- CMyNotepadView: 派生自CView（或CEditView），是我们的视图类，负责显示和编辑文本。
这里有一个关键决策点：视图类的基类选择。默认可能是CView，它是一个通用的视图，需要我们自己处理文本显示和编辑，这很复杂。对于记事本，有一个绝佳的选择：CEditView。CEditView已经内置了一个功能强大的编辑控件（CEdit），自动支持文本显示、编辑、复制、粘贴、撤销等基础功能。这能让我们省去90%的底层文本处理工作。因此，在“生成的类”列表中选择CMyNotepadView，然后在下面的“基类”下拉框中，将其从CView改为CEditView。

完成所有配置后，点击“完成”。Visual Studio会自动生成一个具备基础框架的MFC应用程序，可以直接编译运行。你会看到一个带有菜单、工具栏的空白窗口，这已经是我们的记事本雏形了。

3. 核心功能实现与代码剖析

项目创建好后，我们得到了一个能运行的“空壳”。接下来，我们要注入灵魂——实现记事本的核心功能。得益于我们选择了CEditView作为视图基类，很多基础编辑功能（键入、删除、选择、复制粘贴）已经免费获得了。我们需要聚焦于文件操作和增强功能。

3.1 文档类 (`CMyNotepadDoc`)：数据的管家

文档类的核心任务是管理应用程序的数据。对于记事本，数据就是文本内容。

1. 序列化 (Serialize)：文件读写的核心MFC通过“序列化”机制来简化文件的保存和加载。打开MyNotepadDoc.cpp文件，找到CMyNotepadDoc::Serialize函数。这是框架在“打开”或“保存”文件时自动调用的。

void CMyNotepadDoc::Serialize(CArchive& ar) { // CEditView 已经包含了其编辑控件的序列化逻辑 // 我们只需要调用视图的序列化即可 if (ar.IsStoring()) { // TODO: 在此添加存储代码（保存时） } else { // TODO: 在此添加加载代码（打开时） } // 调用基类（CEditView）的序列化，它会处理编辑控件内的文本 reinterpret_cast<CEditView*>(m_viewList.GetHead())->SerializeRaw(ar); }

上面的代码是理想情况。但这里有个大坑：m_viewList.GetHead()在文档刚创建、尚未与视图关联时可能返回NULL，直接reinterpret_cast会导致崩溃。更稳健的做法是：

void CMyNotepadDoc::Serialize(CArchive& ar) { // 首先尝试序列化我们自己的文档数据（如果有的话） // 例如：ar << m_strCustomData; // 然后序列化编辑控件的内容 POSITION pos = GetFirstViewPosition(); if (pos != NULL) { CView* pView = GetNextView(pos); if (pView != NULL && pView->IsKindOf(RUNTIME_CLASS(CEditView))) { CEditView* pEditView = static_cast<CEditView*>(pView); pEditView->SerializeRaw(ar); // SerializeRaw 直接读写原始文本 } } }

SerializeRaw会直接将编辑控件中的文本以纯文本格式写入文件或从文件读取，完美契合记事本的需求。

2. 维护修改标志 (SetModifiedFlag)文档类有一个重要的布尔标志m_bModified，用于标识文档自上次保存后是否被修改。当用户编辑文本时，我们需要调用SetModifiedFlag(TRUE)。通常，我们会在视图类中响应编辑控件的改变消息来设置这个标志。框架会在关闭未保存的文档时，自动弹出提示框。

3.2 视图类 (`CMyNotepadView`)：交互与呈现的中心

视图类派生自CEditView，它内部包含一个CEdit控件。我们可以通过GetEditCtrl()成员函数获取这个控件的引用，从而进行更精细的控制。

1. 初始化与编码处理在CMyNotepadView::OnInitialUpdate()中，我们可以进行一些初始化设置，比如设置字体。

void CMyNotepadView::OnInitialUpdate() { CEditView::OnInitialUpdate(); // 设置一个等宽字体，更适合代码或文本编辑 CFont font; font.CreatePointFont(100, _T("Consolas")); // 10pt Consolas字体 GetEditCtrl().SetFont(&font); // 注意：font对象不能立即销毁，需要关联到控件生命周期或设为成员变量。 // 更佳实践是：在视图类中定义一个 CFont 成员变量 m_font，在OnCreate中创建，在析构中销毁。 }

编码问题是文本处理的老大难。Windows记事本饱受诟病的一点就是编码探测。我们的简易版可以这样处理：默认使用SerializeRaw，它依赖于当前的字符集设置。为了更好支持Unicode（UTF-16 LE），我们可以重写打开/保存逻辑，但复杂度激增。一个折中方案是：在序列化时，通过CArchive的ReadString/WriteString处理CString对象，CString在Unicode编译环境下内部就是UTF-16。但这对于读取已有ANSI文件可能会乱码。对于实战项目，我们优先保证功能完整，编码问题可以作为一个高级议题后续优化。

2. 响应编辑事件，设置修改标志我们需要知道用户何时修改了文本，以设置文档的修改标志。CEdit控件发送EN_CHANGE通知消息。我们在视图类中添加这个消息映射。

在MyNotepadView.h的类声明中添加消息处理函数声明：

afx_msg void OnEnChange();

在MyNotepadView.cpp的消息映射块 (BEGIN_MESSAGE_MAP) 中添加：

ON_EN_CHANGE(AFX_IDW_PANE_FIRST, &CMyNotepadView::OnEnChange)

AFX_IDW_PANE_FIRST是CEditView内部编辑控件的默认ID。

然后实现该函数：

void CMyNotepadView::OnEnChange() { // 当编辑控件内容变化时，标记文档为已修改 CMyNotepadDoc* pDoc = GetDocument(); ASSERT_VALID(pDoc); if (pDoc) { pDoc->SetModifiedFlag(TRUE); } }

3.3 菜单与命令处理：连接用户操作

资源视图 (Resource View) 是MFC管理菜单、工具栏、字符串表等资源的地方。展开MyNotepad.rc，找到IDR_MAINFRAME菜单资源。我们可以看到，向导已经为我们生成了“文件”、“编辑”等标准菜单项。

1. 文件菜单（新建、打开、保存、另存为、退出）这些命令的ID是标准的，如ID_FILE_NEW,ID_FILE_OPEN,ID_FILE_SAVE,ID_FILE_SAVE_AS,ID_APP_EXIT。MFC框架已经为这些命令提供了默认实现，它们会自动调用文档类的OnNewDocument,OnOpenDocument,OnSaveDocument,OnSaveDocument(另存为) 以及Serialize函数。我们几乎不需要额外编写代码，框架的文档/视图架构已经将其串联起来。这就是使用框架的优势。

2. 编辑菜单（撤销、复制、粘贴、全选等）同样，ID_EDIT_UNDO,ID_EDIT_CUT,ID_EDIT_COPY,ID_EDIT_PASTE,ID_EDIT_SELECT_ALL等命令，由于视图基类是CEditView，它已经为我们实现了这些功能！菜单项会自动生效。你可以尝试运行程序，输入文字，然后使用这些菜单项，它们都是可用的。

3. 实现“查找”功能这是我们需要自己动手实现的一个关键功能。首先，在菜单编辑器中，在“编辑”菜单下添加一个新项：“查找(&F)...”，设置其ID为ID_EDIT_FIND。

然后，我们需要处理这个命令。

在CMainFrame或CMyNotepadView中处理？查找通常涉及弹出对话框并与当前活动视图交互。放在视图类中更合理。
在MyNotepadView.h中声明消息处理函数：
```
afx_msg void OnEditFind();
```

在MyNotepadView.cpp的消息映射中添加：

ON_COMMAND(ID_EDIT_FIND, &CMyNotepadView::OnEditFind)

实现OnEditFind函数。我们需要创建一个“查找”对话框。MFC提供了CFindReplaceDialog类，它是一个非模态对话框，非常适合查找功能。

// 在视图类头文件中添加成员变量 class CMyNotepadView : public CEditView { // ... private: CFindReplaceDialog* m_pFindReplaceDlg; CString m_strFind; BOOL m_bMatchCase; };

// 在视图类实现文件中 void CMyNotepadView::OnEditFind() { // 如果对话框已存在，则激活它 if (m_pFindReplaceDlg != NULL) { m_pFindReplaceDlg->SetActiveWindow(); m_pFindReplaceDlg->ShowWindow(SW_SHOW); return; } // 创建非模态查找对话框 m_pFindReplaceDlg = new CFindReplaceDialog; m_pFindReplaceDlg->Create(TRUE, m_strFind, NULL, FR_DOWN, this); // TRUE表示查找，FALSE表示替换 // 初始化查找选项（可选） m_pFindReplaceDlg->m_fr.Flags |= (m_bMatchCase ? FR_MATCHCASE : 0); }

创建对话框后，还需要处理它发来的消息。CFindReplaceDialog通过ON_REGISTERED_MESSAGE发送WM_FINDREPLACE消息。我们需要注册并处理这个消息，在消息映射中添加：

ON_REGISTERED_MESSAGE(CFindReplaceDialog::GetFindReplaceMsg(), &CMyNotepadView::OnFindReplace)

实现OnFindReplace函数，在这里执行实际的文本查找逻辑（使用CEdit::FindText或CString::Find）。

4. 工具栏按钮更新工具栏按钮的启用/禁用状态需要更新。例如，“复制”、“剪切”按钮只有在有文本被选中时才应该可用。MFC通过ON_UPDATE_COMMAND_UI机制来处理。CEditView已经为我们更新了标准编辑命令的UI。如果我们添加了自定义命令（如查找），也需要为其添加ON_UPDATE_COMMAND_UI处理程序来更新状态。

4. 界面美化与功能增强

基础功能完成后，我们可以让记事本变得更友好、更强大。

4.1 状态栏显示行列信息

一个专业的编辑器应该在状态栏显示当前光标位置（第几行、第几列）。MFC主框架默认有一个状态栏，其ID为AFX_IDW_STATUS_BAR。

在CMainFrame中定义指示器数组：打开MainFrm.cpp，找到indicators数组。在ID_SEPARATOR和ID_INDICATOR_CAPS之间添加我们自己的指示器ID。

static UINT indicators[] = { ID_SEPARATOR, // 状态行指示器，用于显示行列信息 ID_INDICATOR_LINE_COL, // 自定义：行列指示器 ID_INDICATOR_CAPS, ID_INDICATOR_NUM, ID_INDICATOR_SCRL, };

在资源文件中定义字符串资源：在“资源视图”中打开“String Table”，添加一个新的字符串，ID为ID_INDICATOR_LINE_COL，值暂时留空（程序运行时动态设置）。
在视图类中更新状态栏：我们需要在光标移动或文本变化时更新状态栏。可以在视图类中响应EN_UPDATE消息或定时器，计算当前行列号。
- 计算行号：CEdit::LineFromChar(-1)可以获取当前行索引（从0开始）。
- 计算列号：CEdit::LineIndex(-1)获取当前行首字符索引，CEdit::GetSel()获取当前光标位置，两者相减得到列号（从0开始）。
- 获取主框架窗口：AfxGetApp()->m_pMainWnd。
- 获取状态栏：((CMainFrame*)AfxGetApp()->m_pMainWnd)->GetStatusBar()。
- 格式化字符串并设置：CStatusBar::SetPaneText。

4.2 最近文件列表 (MRU)

MFC框架内置了对最近文件列表的支持。在CMyNotepadApp::InitInstance()函数中，有一行代码：

// 启用“最近使用的文件”菜单项和工具栏 SetRegistryKey(_T("本地应用程序向导生成的应用程序")); LoadStdProfileSettings(4); // 加载标准 INI 文件选项（包括 MRU）

LoadStdProfileSettings(4)中的参数4就指定了最近文件列表的最大数量。框架会自动管理这个列表，并在“文件”菜单下显示。我们不需要编写额外代码，只要正确实现了文件的打开和保存，这个功能就能自动工作。

4.3 处理文件拖放

让用户可以直接将文本文件拖拽到我们的记事本窗口打开，能极大提升体验。实现这个功能非常简单，只需要在CMyNotepadApp::InitInstance()函数中，在创建主窗口之前调用：

// 启用拖放打开文件 m_pMainWnd->DragAcceptFiles(TRUE);

更精确的做法是在CMainFrame::OnCreate函数末尾调用DragAcceptFiles(TRUE)。框架会收到WM_DROPFILES消息，并最终调用文档类的OnOpenDocument函数。

5. 编译、调试与发布

5.1 解决常见的编译与链接错误

MSB804: 此项目需要 MFC 库：这是最常见的错误之一。原因是项目设置中MFC库的使用方式不对。右键点击项目 -> “属性” -> “配置属性” -> “高级”，将“MFC的使用”选项从“使用标准Windows库”改为“在共享DLL中使用MFC”或“在静态库中使用MFC”。前者生成文件小，但运行需要目标机器有对应的MFC运行时库；后者生成文件大，但可独立运行。开发调试阶段建议使用“在共享DLL中使用MFC”。
找不到 Windows SDK 版本：确保在项目属性 -> “常规” -> “Windows SDK 版本”中选择了已安装的版本。
字符集问题：项目属性 -> “高级” -> “字符集”，可以选择“使用Unicode字符集”或“使用多字节字符集”。现代Windows程序推荐使用Unicode，能更好支持多语言。这会影响CString、TCHAR等类型的实际定义。我们的代码应使用_T()宏包裹字符串字面量，以保持兼容性。

5.2 调试技巧：追踪MFC消息与数据

TRACE 宏：在调试版本中，可以使用TRACE(_T(“光标位置：行%d, 列%d\n”), nLine, nCol);输出调试信息到Visual Studio的输出窗口。这是最常用的MFC调试手段。
Spy++：Visual Studio自带的工具，可以查看窗口层次结构、消息流，对于理解界面布局和调试消息处理非常有用。
检查文档修改标志：在调试时，可以观察文档对象的m_bModified成员变量，确认保存逻辑是否正确。

5.3 发布可执行文件与依赖项

编译为Release版本：在工具栏的解决方案配置下拉框中选择“Release”。
设置运行时库：项目属性 -> “C/C++” -> “代码生成” -> “运行时库”。对于“在共享DLL中使用MFC”，这里选择“多线程DLL (/MD)”；对于“在静态库中使用MFC”，选择“多线程 (/MT)”。Release版通常选/MD以减小体积。
生成：点击“生成” -> “生成解决方案”。生成的可执行文件（.exe）位于项目目录下的x64\Release或Win32\Release文件夹中。
依赖项检查：
- 如果使用“在共享DLL中使用MFC”，目标计算机需要安装对应版本的Visual C++ Redistributable。你可以将安装包（vc_redist.x64.exe）与你的程序一起分发。
- 使用静态链接（/MT）则无需额外运行时库，但.exe文件会大很多。
- 可以使用Dependency Walker或 Visual Studio自带的dumpbin /dependents MyNotepad.exe命令来查看动态链接的DLL。

6. 进阶思考与扩展方向

完成基础记事本后，你可以尝试以下扩展，这能让你对MFC和Windows编程的理解再深一层：

多文档标签页：将SDI改为MDI，并模仿现代编辑器，在主窗口内实现标签页来切换多个文档。这涉及到自定义标签控件、管理多个文档/视图对象。
语法高亮：继承CEditView或使用CRichEditView，重写OnDraw函数，根据词法分析结果对不同部分（如关键字、注释）进行着色绘制。这是一个挑战性较大的功能。
编码识别与转换：实现类似Notepad++的编码菜单（ANSI, UTF-8, UTF-16 LE/BE）。这需要深入理解BOM（字节顺序标记）和字符集转换API（如MultiByteToWideChar,WideCharToMultiByte）。
插件系统：设计一个简单的插件接口，允许动态加载DLL来扩展功能（如Markdown预览、代码片段管理）。这涉及到动态链接库的显式加载和函数指针调用。
自定义文件格式：超越纯文本，实现一个简单的富文本格式（如RTF）的保存和加载。可以使用CRichEditCtrl替代CEdit。