OFD(Open Fixed-layout Document)是中国国标版式文档格式(GB/T 33190—2016),广泛应用于电子公文、电子发票、电子证照等场景。以下按开源库(按编程语言分类)和商业 SDK两大类整理候选方案,说明核心特点与适用场景。
选型时请区分 **OFD(中国国标版式文档)**与 ODF(OpenDocument 办公文档格式)。二者是不同的文档标准,大量名为
odf-*的开源库仅支持 ODF,不可混用。
本文是选型索引,不是完整的兼容性测试或标准符合性认证。许可证、目标运行时与支持功能应以实际选用版本的官方仓库、发布包和文档为准;开源协议也不自动覆盖字体、第三方依赖和测试样例的授权。
一、开源 OFD 操作库 #
1. Java 生态 #
ofdrw(OFD Reader & Writer) #
- 项目地址:ofdrw/ofdrw。
- 开源协议:MIT。
- 核心特点:模块化的 OFD 处理库,提供解析、字体处理、布局、文件打包、数字签名、文档保护等模块,支持 OFD 生成、编辑、合并、转换与导出。
- 适用场景:Java 后端项目、电子发票和电子公文系统,可作为优先验证的开源候选。
- 集成方式:Maven 引入
ofdrw-full全量包,也可按需引入模块。不要把“功能覆盖较广”理解为所有厂商文件都能无差异处理。
easyofd-java(cn.easyofd:easyofd) #
- 项目地址:11627685/easyofd-java。
- 仓库许可:Apache-2.0;该仓库说明其只包含示例工程,核心库通过 Maven 依赖引入,核心发布包及第三方依赖的许可仍需单独核对。
- 核心特点:项目文档列出 OFD 生成与读取、文字和图形绘制、图片、模板页、资源与附件管理,以及 SM2 / SM3 电子签章、数字签名与验签能力。
- 适用场景:Java 应用中的报表、票据等 OFD 生成,以及需要模板复用、读取或签章接口的项目。
- 集成方式:Maven 坐标为
cn.easyofd:easyofd,仓库 README 的示例版本为2.0.0,环境要求为 JDK 1.8 及以上、Maven 3.x。实际接入时按所选发布包核对 API、依赖与签章互操作表现。 - 同名区分:这是 Java 项目,与 Python 的
renoyuan/easyofd、Rust 的easyofd-rust不是同一个包。
2. .NET / C# 生态 #
Ofdrw.Net #
- 项目地址:whynpc9/ofdrw.net。
- 开源协议:MIT。
- 核心特点:参考 Java
ofdrw的模块划分与目标,由独立的 .NET 实现提供文档生成、读取、编辑、转换和可扩展的签名完整性检查;可通过 NuGet 按需安装。 - 适用场景:需要在 .NET 应用内处理 OFD 的项目。
- 注意事项:不要直接假定与 Java 版功能完全对齐。普通 SDK、CLI 和可选扩展的运行要求不同,应核对安装说明与能力矩阵。
3. Go 语言生态 #
zc310/ofd(OFD Go Toolkit) #
- 项目地址:zc310/ofd。
- 开源协议:Apache-2.0。
- 核心特点:Go 实现的 OFD 工具包,支持解析、创建、渲染、校验、分析,以及 PDF、HTML、图片、SVG、纯文本、Markdown 等格式的转换;提供 Go API、命令行工具与浏览器应用入口。
- 适用场景:Go 后端服务、命令行工具、批量文档处理,以及 WebAssembly 集成。
- 运行依赖:常规 OFD 处理与部分转换使用 Go 实现;Office、HTML 等输入路径可能依赖 LibreOffice、Chrome 等外部程序,字体也需要准备。不能把“Go 实现”概括成所有功能都没有系统依赖,具体见构建与运行文档。
ofdgo(xiaoqidun/ofdgo) #
- 项目地址:xiaoqidun/ofdgo。
- 开源协议:Apache-2.0。
- 核心特点:Go 实现的 OFD 引擎,提供 OFD 读取、编辑和创建等能力,并有 WASM 与 Web 编辑相关入口。
- 适用场景:Go 文档处理、前端交互编辑和 WASM 集成。具体编辑对象与转换表现,应以选用版本和实际样本验证。
4. JavaScript / Node.js 生态 #
@miconvert/ofd-to-pdf #
- 项目地址:huuhuybn/miconvert-ofd-to-pdf。
- 开源协议:Apache-2.0。
- 核心特点:面向 Node.js 的 OFD 转 PDF 库,使用 JavaScript 实现,无需 Java 或 C++ 原生运行环境;提供文字、矢量图形和图片转换,以及中文字体配置。
- 适用场景:Node.js 服务中接入 OFD 转 PDF。
- 注意事项:原生依赖少不等于无需字体,也不能直接推断为可在浏览器运行。转换后的页面、字体与文本提取结果仍需验证。
@hufe921/jsofd #
- 项目地址:hufe921/jsOFD。
- 开源协议:当前 npm 发布元数据标注为 MIT;历史版本请核对相应发布包。
- 核心特点:类 jsPDF 风格的 API,用于通过 JavaScript / TypeScript 生成 OFD 文档。
- 适用场景:浏览器或 Node.js 中动态生成 OFD,具体运行环境和 API 支持以项目文档为准。
@ycsx/ofdjs #
- 项目地址:ycsx/ofd.js。
- 开源协议:Apache-2.0。
- 核心特点:OFD 读取与渲染库,面向网页中的 OFD 展示。
- 适用场景:浏览器端阅读与预览。阅读、生成、编辑和格式转换是不同能力,不应仅凭“支持 OFD”就认为全部具备。
5. C++ 生态 #
libofd #
- 项目地址:uukuguy/libofd。
- 开源协议:MIT。
- 核心特点:较早的 C++ OFD 项目,提供读写、渲染及 PDF 转 OFD 相关工具。
- 适用场景:研究底层结构或评估 C++ 集成方案。
- 注意事项:应特别核对维护状态、构建依赖和实际支持范围,不要仅凭底层语言就推断性能或生产可用性。
Deepin ofd-reader-dtk6 相关阅读器 #
- 定位:Linux 桌面 OFD 阅读器相关软件包,可作为桌面集成的调查线索,不宜直接当作通用 SDK。
- 需要核对:
ofd-reader-dtk6的具体上游、源码包、DTK / Qt 依赖、渲染后端及许可证。不能仅凭软件包名称认定它使用ofdrw、JNI 或某一种开源许可。
6. Python 生态 #
Python 方案中,格式转换与文档解析是常见方向;是否具备完整的读写、排版和签名能力,需要逐个项目确认。
easyofd #
- 项目地址:renoyuan/easyofd,安装入口见 PyPI。
- 核心特点:Python OFD 处理库,项目文档列出 OFD 解析、OFD 转 PDF / 图片、PDF 转 OFD 以及图片转换等能力。
- 适用场景:Python 脚本中的格式转换与文档处理验证。
- 注意事项:需要安装 Python 依赖,并检查字体与转换质量。应与 Java 的
11627685/easyofd-java及 Rust 的easyofd-rust区分,它们不是同一个包。
ofd2img 等转换项目 #
原稿还列出了 ofd2img 这一类 OFD 转图片、PDF 的项目。实际使用前,应先确认具体仓库和包名,再核对 xmltodict、PyMuPDF 等依赖、许可证及样本支持情况,避免同名项目混淆。
此外,odfdo、odfpy 等处理的是 ODF(OpenDocument),不是 OFD 国标文档,选型时务必区分。
二、商业 OFD SDK 方案 #
政企、金融等场景,除了功能和价格,还需要考虑技术支持、部署平台、授权范围和业务合规要求。商业产品也不能仅凭宣传就视为“任意文件完全兼容”。
1. 数科网维 OFD SDK #
- 关注能力:OFD 生成与转换、阅读、文档处理、数字签名、国密签章验章及相关公文流程。
- 平台核对:按采购版本确认 Java、.NET、C++、Web 和移动端入口,不能假设各平台能力相同。
- 适用场景:电子公文、电子证照、电子发票等需要厂商支持的项目。
- 验收重点:实际文档兼容性、签章互认、标准符合性材料,以及授权和服务条款。
2. 福昕 OFD SDK #
- 关注能力:OFD 解析与渲染、PDF / OFD 转换、编辑、签名与加密。
- 平台核对:确认所需的原生接口、语言绑定、Web / 移动端方案,以及目标操作系统和芯片支持。
- 适用场景:企业级格式转换、跨平台文档处理和需要厂商服务的批量处理系统。
- 验收重点:用实际样本测量保真度、内存、并发吞吐及失败行为,而不是只看功能清单。
3. Spire 系列 SDK #
- 关注能力:按具体产品核对 OFD 导入、导出,以及与 PDF、Word、图片相关的转换支持,不能将整个产品系列的能力视为单个 SDK 的能力。
- 覆盖语言:根据产品确认 Java、.NET 或 C++ 版本。
- 版本说明:若使用免费版或试用版,应核对页数、功能、水印和授权限制;这些条件可能因产品及版本不同而变化。
- 适用场景:先验证转换需求,再按实际支持范围、价格与授权方式决定是否采用。
三、选型建议 #
1. 从现有技术栈建立候选集 #
- Java 后端:先验证
ofdrw,按需要选择模块;侧重文字、图形、模板生成与签章接口时,也可评估easyofd-java,并核对其核心 Maven 包。 - Go 服务:把
zc310/ofd与ofdgo放入候选集,分别验证生成、转换、渲染和文本提取需求。 - Node.js:OFD 转 PDF 可评估
@miconvert/ofd-to-pdf;生成 OFD 可评估@hufe921/jsofd。 - 浏览器展示:评估
@ycsx/ofdjs或 WASM 方案,不要把服务端 API 直接当作浏览器 API。 - .NET:评估
Ofdrw.Net,按能力矩阵与运行时要求选择模块。 - Python:从
easyofd等转换项目开始验证,同时检查字体、依赖和结果质量。
2. 商业项目要做针对性验收 #
强合规、政企、跨平台或高并发项目,可以将数科、福昕等商业方案加入测试;预算有限时,也可以先用适用的免费版或试用版验证。最终选择要以样本测试、授权条款和业务验收为依据,不能用品牌替代验证。
3. 把“能生成”与“结果可用”分开 #
先检查页数、金额、表格、图片和印章,再复制正文、搜索关键词,最后测耗时、内存和并发。涉及签章和归档时,应保留原件,并单独验证签名、附件及合规要求。
不同库在画面、文本与性能上的差异,可参考站内的 OFD 与 PDF 互转实测。其中的数字属于指定版本和样本,不是对所有文件的承诺。
资料与核对说明 #
本文整理时核对了上述已链接项目的官方仓库、README / LICENSE,以及 @hufe921/jsofd 的 npm 发布元数据。核对日期为 2026 年 11 月 17 日,不代表所有功能都经过本文实测。采购、上线及再分发前,请再次核对所选版本的文档和许可。