使用 golang 生成 pdf 文档可以通过 gofpdf 库轻松实现。1. 安装 gofpdf：运行 go get github.com/jung-kurt/gofpdf；2. 初始化文档并设置页面参数，如方向、单位和大小；3. 使用 setfont 设置字体样式，通过 cell 或 multicell 添加单行或多行文本；4. 绘制表格可通过组合 cellformat 和边框控制实现；5. 插入图片需调用 imageoptions 并指定路径与尺寸；6. 可自定义页眉页脚添加 logo 或页码。掌握这些基础操作即可满足常见 pdf 生成需求。
用 Golang 生成 PDF 文档其实并不复杂，尤其是借助像 gofpdf 这样的第三方库，可以快速实现文本、表格、图片等内容的输出。这篇文章主要讲讲怎么用 gofpdf 做一些基础绘制操作，适合刚上手或想快速集成 PDF 生成功能的同学。
安装 gofpdf 并初始化文档
使用 gofpdf 的第一步当然是安装它。你可以通过下面这个命令来引入：
go get github.com/jung-kurt/gofpdf
然后在代码中导入并创建一个新文档。基本结构如下：
立即学习“go语言免费学习笔记（深入）”；
package main
import (
"github.com/jung-kurt/gofpdf"
)
func main() {
pdf := gofpdf.New("P", "mm", "A4", "") // 创建一个 A4 纵向的 PDF 文档
pdf.AddPage()
pdf.SetFont("Arial", "", 12)
pdf.Cell(40, 10, "Hello, World!")
pdf.OutputFileAndClose("hello.pdf")
}这里有几个参数需要注意：
-
"P"表示页面方向是纵向（Portrait），也可以用"L"表示横向（Landscape） -
"mm"是单位，你也可以用"pt"或"cm" -
"A4"是纸张大小，也支持自定义尺寸
添加文字内容：字体、样式与排版
添加文字是 PDF 中最常见的需求。gofpdf 支持多种字体设置，比如加粗、斜体、下划线等。
举个例子，你想让一段说明文字显示得更正式一点，可以这样写：
pdf.SetFont("Times", "B", 14) // 设置字体为 Times New Roman，加粗，字号 14
pdf.Cell(0, 10, "这是标题")
pdf.Ln(10) // 换行，间距为 10 mm
pdf.SetFont("Arial", "", 12)
pdf.MultiCell(0, 5, "这是一个多行文本示例，会自动换行。\n你可以在这里写很多内容。", "", "L", false)几点建议：
- 使用
SetFont可以灵活切换字体和样式 -
Cell和MultiCell的区别在于后者支持自动换行 - 如果你想要中文支持，记得先调用
AddFont加载中文字体文件
绘制表格和线条：结构化数据展示
虽然 gofpdf 没有直接提供“表格”函数，但可以通过画线 + 单元格组合来实现简单的表格效果。
例如，绘制一个两列的表格头：
pdf.SetFont("Arial", "B", 12)
pdf.CellFormat(60, 10, "姓名", "1", 0, "", false, 0, "")
pdf.CellFormat(60, 10, "年龄", "1", 0, "", false, 0, "")
pdf.Ln(-1)
pdf.SetFont("Arial", "", 12)
pdf.CellFormat(60, 10, "张三", "1", 0, "", false, 0, "")
pdf.CellFormat(60, 10, "28", "1", 0, "", false, 0, "")
pdf.Ln(-1)这里用了 CellFormat 来控制边框，最后一个参数 -1 表示自动换行高度。你可以根据需要扩展成更多行和列。
插入图片和其他元素
插入图片也很简单，只需要准备一张图片文件，然后指定位置和大小即可：
pdf.ImageOptions("logo.png", 10, 10, 30, 0, false, gofpdf.ImageOptions{ImageType: "PNG"}, 0, "")注意点：
- 图片路径要是相对路径或绝对路径
- 支持 PNG 和 JPG 格式
- 第三个参数是宽度，设为 0 表示按比例缩放
如果你想加页眉页脚，可以用 SetHeaderFunc 和 SetFooterFunc 自定义内容，比如加上公司 Logo 或页码。
基本上就这些了。
gofpdf 虽然不是功能最全的 PDF 库，但对于大多数常见的报表、发票、导出文档等场景已经足够使用。只要掌握好字体、布局、绘图这几个核心点，就能做出比较实用的 PDF 文件。
