NPOI 不支持 Word 文档操作，仅支持 Excel 和有限 PowerPoint；Aspose.Words 是最稳的商业方案；Open XML SDK 是免费替代方案；Microsoft.Office.Interop.Word 生产环境应禁用。
用 NPOI 操作 Word 文档？别试了，它不支持
NPOI 是 Apache POI 的 .NET 移植版，但只实现了 Excel（HSSFWorkbook / XSSFWorkbook）和 PowerPoint（有限支持），完全不支持 Word（.doc / .docx）格式。如果你在 NuGet 里搜 NPOI 并尝试调用类似 HWPFDocument 或 XWPFDocument，会直接报错：Type or namespace name 'XWPFDocument' could not be found —— 因为这些类根本没被移植进来。
常见误操作包括：
- 误以为
NPOI和 Java 的 POI 功能对等，实际能力差一个文档类型 - 在项目中引用
NPOI后硬写new XWPFDocument()，编译失败 - 查到过时博客（2015年前）提到“NPOI 支持 Word”，那是混淆了社区未合并的实验分支
Aspose.Words 是最稳的纯 C# Word 方案
Aspose.Words for .NET 是目前 C# 生态中功能最完整、稳定性最高、文档最全的 Word 处理库。它不依赖 Office 安装，纯托管代码，支持 .doc、.docx、.rtf、甚至 PDF 导出。
关键实操点：
- 安装：NuGet 包名是
Aspose.Words（注意不是Aspose.Words.Core等变体） - 基础生成示例：
var doc = new Document(); var builder = new DocumentBuilder(doc); builder.Writeln("Hello, World!"); doc.Save("output.docx"); - 编辑已有文件：
var doc = new Document("template.docx")，然后用DocumentBuilder定位段落、替换文本、插入表格等 - 性能提示：大文档（>100页）建议关闭格式校验：
LoadOptions { LoadFormat = LoadFormat.Docx, WarningCallback = null }
注意：Aspose.Words 是商业库，免费版有页眉/页脚/水印等限制，且每页顶部带评估标签；正式环境需购买许可证。
免费替代方案：用 Open XML SDK 直接写 .docx
如果你必须零成本、又接受一定复杂度，DocumentFormat.OpenXml（微软官方 SDK）是唯一靠谱选择。它操作的是 Word 的底层 XML 结构，不渲染、不解析样式逻辑，但足够可靠。
Word报告自动生成神器。自动生成专业Word文档报告，支持模板填充、目录生成、表格/图表插入、页眉页脚、多级标题、样式主题、批量邮件合并。当用户需要生成Word报告、创建合同文档、批量生成通知/证书、填充Word模板、制作商业计划书时触发。
典型使用场景：
- 生成结构简单、样式固定的报告（如发票、日志导出）
- 批量替换模板中的占位符（
«OrderID»→"ORD-2024-001"） - 需要精确控制段落属性、字体嵌入、自定义 XML 部件
坑点提醒：
- 没有“所见即所得”构建器，所有内容都靠手动创建
Paragraph、Run、Text对象 - 中文乱码？确保
RunProperties.FontSize和RunProperties.RunFonts正确设置 - 必须显式调用
mainPart.Document.Body.Append(paragraph)，漏掉就啥也不显示 - 推荐搭配
OpenXmlPowerTools简化查找替换（如ContentAccessor.ReplaceText）
为什么别用 Microsoft.Office.Interop.Word？
虽然能跑，但生产环境基本等于埋雷。
核心问题：
- 必须在服务器装对应版本的 Word（.NET Core/.NET 6+ 还可能因 COM 权限失败）
- 进程不释放导致
WINWORD.EXE僵尸进程堆积，CPU 占满 - 多线程调用会崩溃，必须加锁或单线程池串行处理
- 错误信息极不友好，比如
HRESULT: 0x800A175D实际只是路径不存在
仅适合：本地开发调试、一次性小工具、且明确知道目标机器永远装着 Office。
真正要上线的系统，interop 不是“不推荐”，是“应该视为禁用”。
