简介这份资源面向具备一定 Visual C 基础的开发者聚焦 MFC 框架下通过 COM/OLE 自动化接口创建 Word 文档并写入文本、段落与表格等内容的完整实现。包内共 30 个文件以 17 个 .h 头文件与 4 个 .cpp 源文件为核心涵盖 CApplication、CDocuments、CTable、CCell、CWordOp 等封装类另含 vcxproj 工程文件、rc 资源脚本、ico 图标及可执行文件压缩包约 268KB结构清晰便于对照阅读。已有 146 人学习下载。读者可从中获取 Word 自动化对象的引用计数管理、Range 与 Table 操作、SaveAs 保存等关键代码范例理解 COM 智能指针的释放时机与内存泄漏规避思路适合作为办公自动化、报表导出类项目的参考模板与排错依据。1. MFC 写 Word 这件事为什么 2025 年还有人认真做接手一个工业上位机项目时需求方丢过来一句话设备跑完一轮自动出一份带表格的检测报告Word 格式产线主管要能直接打印签字。界面是 MFC 写的跑了快十年重构成 Qt 或 Web 不现实。于是问题变成在 MFC 程序里创建 Word 文档、写入段落和表格怎么做得稳、做得不翻车。这个方向在 2025 年依然有真实需求。MFC 教程里讲界面、讲状态栏、讲 onclose 的资料很多但把数据落到 Word 文档这一步往往被一句“用 COM 调 Word”带过真动手才发现坑不少客户机器上没装 Office 怎么办、Word 进程退不干净怎么办、表格列宽设了不生效怎么办。这篇笔记就按我实际做过的路径把选型、代码、参数和踩坑一次讲清楚适合正在用 MFC 做桌面软件、需要导出 Word 报表的开发者。2. 先定路线MFC 操作 Word 的三条路和选型理由2.1 COM 自动化、OLE 嵌入、直接写 docx 的差别在 MFC 里往 Word 写数据常见做法有三条选错了后面全是返工。第一条是 COM 自动化也就是通过COleDispatchDriver或#import引入 Word 的类型库直接驱动本机安装的 Word 进程。优点是功能最全段落、表格、样式、页眉页脚、甚至插入公式图片都能做写出来的就是原生 Word 文档。缺点也明显目标机器必须装 Word进程管理稍不注意就残留WINWORD.EXE。第二条是 OLE 嵌入把 Word 文档当作 OLE 对象嵌到视图里。这条路适合“在程序里内嵌一个 Word 编辑区”的场景比如让用户在软件里直接编辑文档。但如果只是后台生成报告用 OLE 属于杀鸡用牛刀窗口消息和焦点问题会让你怀疑人生。第三条是不依赖 Word直接按 OOXML 规范生成 docx。docx 本质是个 zip 包里面是 XML。你可以用第三方库也可以自己拼 XML 再打包。优点是部署机器不需要 Office速度快、无进程残留。缺点是复杂排版域、公式、复杂样式要自己啃规范表格合并、列宽这些细节得手动算。我的选型习惯是报告要打印、要签字、格式要求高且能确认客户机器装了 Office就走 COM如果是服务端批量生成、机器干净就走直接写 docx。下面重点讲 COM因为它和 MFC 结合最自然也是热搜里“MFC 创建 word 文档”最常指向的做法。2.2 用 #import 引入 Word 类型库的最小工程配置在 MFC 工程里用 COM 操作 Word第一步是把 Word 的类型库引进来。常见做法是在stdafx.h或某个公共头文件里加#import。// 在 stdafx.h 或公共头文件中引入 Word 类型库 // 8 和 0 是主版本和次版本实际以本机 Office 版本为准 // 使用 raw_interfaces_only 避免生成大量包装函数减少命名冲突 #import C:\\Program Files\\Microsoft Office\\root\\Office16\\MSWORD.OLB \ rename(ExitWindows, WordExitWindows) \ rename(FindText, WordFindText) \ raw_interfaces_only这段代码的逻辑是编译器读取MSWORD.OLB类型库生成对应的 C 包装类。rename是为了避开 MFC 或 Windows 头文件里已有的同名符号比如ExitWindows、FindText不加会报重定义。raw_interfaces_only让生成的接口更接近底层调用时用raw_前缀的方法参数是VARIANT和BSTR虽然啰嗦但可控。参数说明MSWORD.OLB的路径随 Office 版本和安装位置变化Office 2016/2019/365 常见在Office16目录下。如果编译报找不到文件去注册表HKEY_CLASSES_ROOT\TypeLib下找 Word 的类型库路径或者用CLSIDFromProgID动态创建。注意#import会生成.tlh和.tli文件放在工程中间目录清理重建时如果报奇怪的错先删掉这两个文件再编译。提示如果目标机器可能没装 Word#import编译出来的程序在运行时创建 Word 对象会失败必须做异常捕获和降级处理不能假设一定成功。3. 动手写从创建文档到写入表格的完整代码3.1 初始化 COM 并创建 Word 应用的封装MFC 程序里用 COM线程初始化不能忘。主线程一般 MFC 已经初始化过但如果你在工作者线程里生成 Word必须自己调CoInitialize。// 封装一个简单的 Word 自动化类负责生命周期管理 class CWordAutomation { public: CWordAutomation() : m_pApp(NULL), m_pDoc(NULL) {} ~CWordAutomation() { Close(); } BOOL CreateDocument() { // 创建 Word 应用对象 if (!m_pApp.CreateDispatch(_T(Word.Application))) return FALSE; // 不显示 Word 界面后台生成 m_pApp.put_Visible(FALSE); // 关闭系统提示避免弹窗卡住自动化 m_pApp.put_DisplayAlerts(FALSE); // 新建文档 LPDISPATCH pDoc m_pApp.get_Documents().Add(); if (pDoc NULL) return FALSE; m_pDoc.AttachDispatch(pDoc); return TRUE; } void Close() { if (m_pDoc.m_lpDispatch ! NULL) { // 关闭文档时不保存由外部决定是否另存 m_pDoc.Close(FALSE, vtMissing, vtMissing); m_pDoc.ReleaseDispatch(); } if (m_pApp.m_lpDispatch ! NULL) { m_pApp.Quit(FALSE, vtMissing, vtMissing); m_pApp.ReleaseDispatch(); } } CWord::_Application m_pApp; CWord::_Document m_pDoc; };逻辑说明CreateDispatch通过 ProgID 启动 Word 进程并拿到应用对象。put_Visible(FALSE)让 Word 在后台跑用户看不到界面适合自动生成报告。put_DisplayAlerts(FALSE)很关键否则 Word 在关闭或覆盖文件时弹对话框自动化流程会卡死。Documents.Add()新建一个空文档。参数说明Close和Quit的参数里vtMissing是#import生成的缺省参数占位符表示用默认值。Close(FALSE, ...)的第一个参数表示不保存更改如果你需要保存改成TRUE或调用SaveAs。注意Quit之后一定要ReleaseDispatch否则引用计数不归零Word 进程残留。3.2 写入段落、设置字体和插入表格文档有了接下来写内容。下面这段演示写标题、正文再插入一个 3 列的表格并填数据。void WriteReport(CWordAutomation word) { CWord::_Document doc word.m_pDoc; CWord::Range range; // 写入标题段落 range doc.get_Content(); range.InsertAfter(_T(设备检测报告\r\n)); range.put_Bold(TRUE); // 加粗 range.put_Size(16); // 字号 16 range.put_Name(_T(黑体)); // 字体 // 写入正文重置格式 range doc.get_Content(); range.InsertAfter(_T(检测时间2025-01-01\r\n)); range.put_Bold(FALSE); range.put_Size(10.5); range.put_Name(_T(宋体)); // 在文档末尾插入表格3 行 3 列 CWord::Tables tables doc.get_Tables(); CWord::Range endRange doc.get_Content(); endRange.Collapse(1); // 1 表示折叠到末尾 CWord::Table table tables.Add(endRange, 3, 3); // 填充表格数据 for (int row 1; row 3; row) { for (int col 1; col 3; col) { CString strValue; strValue.Format(_T(R%dC%d), row, col); table.get_Cell(row, col).get_Range().put_Text(strValue); } } // 设置表格边框wdLineStyleSingle 1 table.put_Borders(1); }逻辑说明get_Content()拿到整个文档的内容区域InsertAfter在末尾追加文本。每次写新段落前重新取Content并设置格式避免格式串到下一段。插入表格时Tables.Add的第一个参数是插入位置这里用折叠到末尾的 Range保证表格加在正文后面。get_Cell(row, col)的行列从 1 开始不是 0这点和 C 数组习惯不同容易踩坑。参数说明put_Size(10.5)是磅值Word 里五号字约 10.5 磅。Collapse(1)的参数 1 表示wdCollapseEnd0 表示wdCollapseStart。put_Borders(1)里的 1 是wdLineStyleSingle给表格加单线边框。如果你要设置列宽用table.get_Columns().Item(i).put_Width(...)单位是磅具体见下一章的坑。3.3 保存为 docx 并正确退出 Word 进程写完内容必须保存然后干净地退出否则任务管理器里会堆一堆WINWORD.EXE。void SaveAndQuit(CWordAutomation word, LPCTSTR lpszPath) { // 另存为 docxwdFormatXMLDocument 12 word.m_pDoc.SaveAs2(COleVariant(lpszPath), COleVariant((long)12)); // 关闭文档不额外保存 word.m_pDoc.Close(FALSE, vtMissing, vtMissing); word.m_pDoc.ReleaseDispatch(); // 退出 Word 应用 word.m_pApp.Quit(FALSE, vtMissing, vtMissing); word.m_pApp.ReleaseDispatch(); // 处理消息确保 COM 释放消息被泵出 MSG msg; while (PeekMessage(msg, NULL, 0, 0, PM_REMOVE)) { TranslateMessage(msg); DispatchMessage(msg); } }逻辑说明SaveAs2的第二个参数是文件格式12 对应wdFormatXMLDocument即 docx。保存后先关文档再退应用顺序不能反。最后泵一下消息队列是因为 COM 释放时可能投递消息不处理会导致进程退出延迟或残留。参数说明COleVariant((long)12)显式转成 long避免 VARIANT 类型推断错误。Quit的参数FALSE表示不保存未保存的更改因为前面已经 SaveAs 过。如果你的程序在工作者线程里跑记得线程退出前CoUninitialize。4. 避坑排查Word 自动化最常见的 5 个翻车现场4.1 进程残留任务管理器里一堆 WINWORD.EXE现象程序跑完Word 文档生成了但任务管理器里WINWORD.EXE越积越多机器越来越卡。原因ReleaseDispatch没调或者Quit之后还有未释放的接口指针。COM 引用计数不为零Word 进程不会退出。另一个常见原因是DisplayAlerts没关Word 弹了隐藏对话框进程卡住。解决确保每个CreateDispatch或get_xxx拿到的接口都ReleaseDispatch。用 RAII 封装析构时统一释放。Quit后泵消息。调试时可以在Quit前后打印引用计数或者用GetLastError看有没有异常。4.2 表格列宽设了不生效现象代码里调了put_Width生成的 Word 里表格列宽还是自动的或者拖不动。原因Word 表格有“自动调整”行为Table.AutoFitBehavior会覆盖你设的列宽。另外Columns.Item(i).Width的单位和Cell.Width不同设错对象白费劲。解决先关自动调整再设列宽。常见做法是table.put_AllowAutoFit(FALSE)然后table.get_Columns().Item(1).put_Width(100)。单位是磅1 厘米约 28.35 磅。如果列宽还是不对检查是不是在AutoFitBehavior之后设的顺序反了会被覆盖。4.3 目标机器没装 Office 直接崩现象开发机跑得好好的客户机器上一点“生成报告”就报错或闪退。原因CreateDispatch(_T(Word.Application))失败返回 FALSE但代码没判断后面继续调空指针。解决所有 COM 调用都要判返回值。CreateDispatch失败时给用户明确提示或者降级到直接写 docx 的方案。如果客户机器装的是 WPSProgID 可能不同常见做法是尝试Word.Application和KWPS.Application两个 ProgID哪个成功用哪个。4.4 写入中文乱码或问号现象生成的 Word 里中文变成乱码或问号。原因CString到BSTR的转换用了错误的编码或者源文件编码和工程字符集不匹配。MFC 工程分多字节和 Unicode#import生成的接口默认按BSTR宽字符传参。解决确认工程字符集。Unicode 工程直接用CString的AllocSysString转BSTR。多字节工程需要先转宽字符再传。源文件保存为带 BOM 的 UTF-8 或 GBK和工程设置一致。写入前可以用SysAllocString手动构造BSTR验证。4.5 自动化速度慢生成一份报告要十几秒现象报告内容不多但生成一次要十几秒产线等不起。原因每次InsertAfter或put_Text都触发 Word 重排和屏幕刷新虽然Visible是 FALSE但内部刷新还在。另外频繁跨进程 COM 调用本身有开销。解决批量写入。先把内容拼成一个长字符串一次InsertAfter写完再统一设格式。表格数据可以先在内存里组织好减少get_Cell的调用次数。如果还是慢考虑直接写 docx 的方案速度能快一个数量级。5. 进阶技巧用书签定位和模板复用把报告做活前面讲的是从零创建文档。实际项目里更常见的做法是先做一个 Word 模板里面放好书签和表格样式程序只负责往书签位置填数据。这样排版交给美工程序只管数据维护成本低很多。具体做法是在模板文档里插入书签比如Bookmark_DeviceName、Bookmark_TestTime。程序打开模板通过doc.get_Bookmarks().Item(_T(Bookmark_DeviceName)).get_Range().put_Text(...)填值。表格也可以用书签定位在书签位置插入表格样式直接继承模板里的定义。// 打开模板并往书签写数据 CWord::_Document doc word.m_pApp.get_Documents().Open( COleVariant(_T(D:\\ReportTemplate.docx)), vtMissing, vtMissing, vtMissing, vtMissing, vtMissing, vtMissing, vtMissing, vtMissing, vtMissing, vtMissing, vtMissing, vtMissing, vtMissing, vtMissing); // 往书签写设备名 CWord::Bookmark bm doc.get_Bookmarks().Item(_T(Bookmark_DeviceName)); bm.get_Range().put_Text(_T(一号检测仪)); // 往书签位置插入表格 CWord::Range bmRange bm.get_Range(); CWord::Table table doc.get_Tables().Add(bmRange, 5, 4);参数说明Documents.Open的参数很多#import生成的版本里大部分可以用vtMissing占位只传文件名。书签的Range在插入表格后会被替换如果同一个书签要多次使用注意重新获取。模板方案的一个坑是书签在 Word 里如果被删除或改名程序会找不到建议在程序启动时校验模板里的书签列表缺了就报错别等生成到一半才崩。另一个技巧是复用 Word 应用实例。如果程序要连续生成多份报告不要每份都CreateDispatch和Quit而是启动一个 Word 实例反复Documents.Add和Close最后统一退出。这样省去反复启动进程的开销速度提升明显。但要注意文档之间的状态隔离比如样式、页眉最好每份都从模板新建。验证生成结果是否正确的习惯我会在程序里加一个“生成后自动打开”的调试开关开发阶段打开看效果发布时关掉。另外用doc.get_Paragraphs().get_Count()和doc.get_Tables().get_Count()断言段落数和表格数防止内容漏写。这些检查花不了几行代码但能省下大量返工。最后说个血泪经验Word 自动化在 Office 更新后偶尔会出玄学问题比如某个方法参数变了、某个属性不认了。所以工程里最好把 Word 操作封装成独立模块接口稳定底层实现可替换。哪天 COM 走不通了换成直接写 docx 的库上层业务代码不用动。希望帮到你。本文还有配套的精品资源点击获取