↓ 跳过正文
  1. 文章/

OFD 操作库推荐:按开发语言与业务场景选择开源库和商业 SDK

目录

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 日,不代表所有功能都经过本文实测。采购、上线及再分发前,请再次核对所选版本的文档和许可。

相关文章

OFD 与 PDF 互转实测:最快的不一定能用,99% 相似也不代表文字没丢

数据快照:2026 年 11 月 16 日。本文基于 zc310/ofd-benchmark 仓库的双向测试结果,具体版本与原始报告见文末。 收到一张 OFD 发票,想转成 PDF,方便预览、打印和分享。 业务系统里有一批 PDF,又需要转成 OFD,对接归档流程。 听起来像同一件事的两个方向:找个库,换一下输入和输出就好了。 真正接入系统后,问题却一个接一个:文件生成了,页面为什么少了字?画面看着一样,复制出来为什么是乱码?转换只花几十毫秒,得到的内容真的完整吗? 这次,我们不只看“支持转换”四个字,而是把 OFD→PDF 的 9 种方案、PDF→OFD 的 6 种方案放进同一套基准,比较速度、体积、画面和文本。 先说最重要的结论: 生成文件、画面对、文字对,是三件不同的事。选型时,顺序应该是先验质量,再比性能。

ofd-compare:从文字、结构到画面,核对 OFD 文档版本差异

同一份合同,收到“原稿”“修改稿”“最终稿”三个版本。对方说只调整了日期,你还得确认金额、收款账户、页面内容有没有一起变动。 打开两个窗口来回切换,短文档还能应付。页数多了,金额只改一个数字、图片挪了一点位置、某一页插进了新内容,都很容易漏看。 做系统开发时也会遇到类似问题:模板改版后,正文是否一致?重新生成 OFD 后,哪些资源变了?页面看起来一样,为什么文件摘要不同? 这次介绍 zc310/ofd 项目中的一个工具:ofd-compare。 它以一份 OFD 为基准,比较其他版本的包内文件、XML 结构、页面文字和渲染画面,生成可以在浏览器中离线查看的报告。需要接入脚本或系统时,也可以输出 JSON、文本和 Markdown。

不装软件、不上传文件:一个纯前端 OFD 工具箱,把转换、校验、发票抽取全塞进了浏览器

同事甩给你一个 .ofd 文件——发票、合同、电子证照,现在越来越多是这种格式。你双击,打不开;想转成 PDF 发给客户,搜到的工具要么让你先注册账号,要么让你上传到它的服务器再下载。 发票里有税号、金额、开票方,合同里有公章和签署信息。这些东西你敢往陌生网站上贴吗? 装个桌面软件?平台、安装和升级都要考虑,而且有的工具只做“转 PDF”一件事。想校验一下文件结构、看看到底有哪些资源、批量把几十张发票的金额汇总出来,还需要更多工具配合。 今天聊的这个开源项目就是冲这些痛点来的:zc310/ofd-toolbox——一个用 Go 编译成 WebAssembly 的纯前端 OFD 工具箱。文件不上传,没有处理文档的服务端,也没有账号,打开网页就能用。 在线使用:OFD 工具箱。

go ofd 转 pdf

·1 分钟
这周 把去年计划用go写个ofd 阅读器的代码补上了转pdf或png ,代码 https://github.com/zc310/ofd 还差实现简单阅读器 看看用 gioui.org 实现一个简单的类似 MuPDF 那种效果的。