C产品如何满足特定用户需求？

本文共计820个文字，预计阅读时间需要4分钟。

该COM组件可生成，但不宜用于服务器或无界面环境。此组件依赖本地安装的Word应用程序，运行时可能出现弹窗、崩溃、权限异常，且在Linux/macOS或无桌面的Windows Server上直接失败。

常见错误现象：COMException: 检索 class factory 失败、RPC_E_SERVERFAULT、进程残留（WINWORD.EXE 占满 CPU）。

• 仅适合开发机本地调试，且已装 Office
• 必须手动调用 application.Quit() 并释放 COM 对象（Marshal.ReleaseComObject），否则内存泄漏
• 生成的文件默认是 .doc 格式，需显式指定 WdSaveFormat.wdFormatXMLDocument

推荐方案：用 OpenXML SDK 直接写 .docx

.docx 本质是 ZIP 包含 XML 文件，OpenXML SDK 是微软官方、零依赖、纯托管库，支持 .NET Core/.NET 5+，无需 Office 安装。

安装包：DocumentFormat.OpenXml（NuGet 包）

• 创建空白文档只需几行：new WordprocessingDocument(..., FileMode.Create)
• 核心对象链： MainDocumentPart → Body → Paragraph → Run → Text
• 中文乱码？确保 Text 节点内容是普通字符串，不要手动编码；字体设置非必需，Word 默认兼容
• 性能好：生成千页文档也只耗几十 MB 内存，无进程开销

using (var doc = WordprocessingDocument.Create("out.docx", WordprocessingDocumentType.Document)) { var mainPart = doc.AddMainDocumentPart(); mainPart.Document = new Document(); var body = mainPart.Document.Append(new Body()); var para = body.Append(new Paragraph()); para.Append(new Run(new Text("Hello, 世界"))); }

更简单：用 DocX 库快速填充模板

如果只是替换文字、插入表格或图片，DocX（由 Xceed 提供）封装更友好，API 接近 Word UI 操作习惯，适合业务逻辑为主的场景。

• 不依赖 OpenXML SDK 的底层细节，例如：doc.ReplaceText("{{name}}", "张三")
• 支持段落样式、表格、图片插入、页眉页脚，但复杂版式（如分栏、文本框）支持有限
• 注意版本：.NET 6+ 请用 DocX.NET（社区维护分支），原 DocX 已停止更新
• 生成速度略慢于 OpenXML（因内部仍基于它封装），但开发效率高得多

为什么不能用 FileStream + 手动拼 ZIP/XML？

理论上可行，但实际极容易出错——.docx 的 XML 结构有严格命名空间、关系（rels）、内容类型（[Content_Types].xml）和校验要求。少一个 xmlns 或关系 ID 错位，Word 就提示“文件已损坏，是否尝试恢复？”

• OpenXML SDK 已处理所有这些细节，包括自动维护 relationships 和 Content_Types
• 手写 ZIP 容易导致 ZIP 中央目录错位，尤其在追加内容时
• 调试成本远高于引入一个 NuGet 包

真正需要控制底层字节的场景极少，比如做文档加密中间件或离线嵌入签名，否则没必要绕过 SDK。