Golang生成PDF工具教程详解

本篇文章给大家分享《Golang实现PDF生成工具教程》，覆盖了Golang的常见基础知识，其实一个语言的全部知识点一篇文章是不可能说完的，但希望通过这些问题，让读者对自己的掌握程度有一定的认识(B 数)，从而弥补自己的不足，更好的掌握它。

用Golang生成PDF应首选go-pdf/fpdf库，通过嵌入中文字体、代码驱动布局及避坑技巧实现轻量可控的纯Go方案。

用 Golang 生成 PDF，核心是选对库、理清流程、避开常见坑。不依赖外部服务、不调用系统命令，纯 Go 实现才真正轻量可控。

主流 PDF 生成库对比：选择合适工具

Go 生态中较成熟的 PDF 生成库有三个方向：

• unidoc/unipdf：功能最全（支持加密、表单、数字签名），但免费版限制页数，商用需授权
• go-pdf/fpdf：轻量、无依赖、API 类似 PHP 的 FPDF，适合生成结构简单、内容固定的报表或票据
• gofpdf（已归档）和 pdfcpu（侧重 PDF 处理而非生成）不推荐作为主力生成工具

日常项目建议从 go-pdf/fpdf 入手——它体积小、文档清晰、中文支持通过 UTF8 字体包可解决，上手快且无隐性成本。

中文支持：字体嵌入是关键一步

默认 fpdf 不支持中文，直接写汉字会显示为空白或方块。必须显式加载并注册中文字体（如 NotoSansCJK 或 simsun.ttc）：

• 下载一个支持 GBK/UTF-8 的 TrueType 字体文件（例如 simsun.ttc）
• 用 fpdf.AddUTF8Font() 注册字体，指定别名（如 "sim"）
• 后续调用 SetFont("sim", "", 12) 即可正常输出中文

注意：字体文件需随二进制一起分发，或内置为 embed.FS（Go 1.16+），避免运行时路径错误。

结构化生成：从模板到数据填充

实际业务中很少“从零画 PDF”，多数是“填模板”。推荐两种模式：

• 静态模板 + 数据替换：用 HTML + CSS 写好布局，再用 gofpdf 或 pdfg（基于 Chromium 的 headless 渲染）转成 PDF —— 适合复杂排版、带样式的报告
• 代码驱动布局：用 fpdf 的 Cell()、MultiCell()、Image() 等方法逐块拼接，配合 SetX()/SetY() 控制位置 —— 适合发票、物流单、证书等格式固定场景

例如生成一张订单凭证：先设置页边距、标题字体，再用 MultiCell() 输出订单号、客户信息、商品列表（循环绘制每行），最后加一条横线和签章区域。

实用技巧与避坑提醒

• 页码用 AliasNbPages() 和 Footer() 自动注入，不用手动算总页数
• 表格建议用 Cell() 拼接 + 固定宽度控制，避免用 Write() 导致换行错位
• 图片尺寸要预计算，ImageOptions{ImageType: "JPEG"} 显式声明类型，防止解析失败
• 生成结果用 OutputFileAndClose("out.pdf") 调试，上线后改用 Output() []byte 直接返回 HTTP 响应体

基本上就这些。不复杂但容易忽略细节，尤其字体和坐标系——多跑两次 demo，比读十页文档更管用。

到这里，我们也就讲完了《Golang生成PDF工具教程详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！