Open XML SDK官方NuGet包选DocumentFormat.OpenXml还是Open-XML-SDK？

哪个是官方维护的正版包 #

• 目前微软官方主推、作为Open XML SDK唯一正式对外发布渠道的NuGet包是DocumentFormat.OpenXml，所有官方文档、示例教程、生产项目引用的都是这个包。
• 出现在搜索结果里的Open-XML-SDK不是第三方蹭热度的仿冒包，它和前者是同一套官方代码库的同步发布产物，不存在功能、安全上的本质差异。

日常开发的实际选择建议 #

• 直接选DocumentFormat.OpenXml就对了，没有任何场景需要优先选择另一个包。
  • 这个包的发布历史超过15年，覆盖了从最早的Open XML SDK 2.0到最新版本的全量迭代，所有兼容逻辑都经过了千万级项目的生产环境验证
  • 庞大的累计下载量对应的是最完善的开发生态：遇到兼容问题时能搜到的解决方案、第三方适配工具、开源示例，全都是围绕这个包名构建的，几乎不会出现搜不到参考资料的情况
  • 不存在长期维护风险：作为微软沿用十几年的正式NuGet包ID，后续所有新功能、安全补丁都会第一时间推送到这个包上，不会出现版本滞后、停更的问题

两个高度相似包的形成原因 #

• 这是项目开源托管过程中留下的历史痕迹，完全不是第三方恶意抢注：
  • 早期Open XML SDK是微软内部交付的桌面安装组件，NuGet平台上线之初，就确定了DocumentFormat.OpenXml作为官方NuGet包的正式ID，持续发布了十余年
  • 后续微软将整个Open XML SDK项目开源，代码托管的公开仓库名称定为Open-XML-SDK。为了降低用户的搜索成本，让那些直接搜仓库名找对应NuGet包的开发者能快速定位到正确组件，官方在同一条自动发布流水线上，额外同步推送了一个和仓库同名的NuGet包。两个包的编译产物、版本号、功能完全一致，甚至连包的描述文本都是复制的同一套元数据，没有做差异化设计
  • 因为老包的用户认知度更高、积累时间更长，累计下载量才会远高于后来同步推送的仓库同名包，最终造成了两个包高度相似、更新节奏完全一致、但下载量差距极大的搜索结果观感

内容的提问来源于stack exchange，提问作者Lei Yang