用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）：
立即学习“go语言免费学习笔记（深入）”；
- 下载一个支持 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，比读十页文档更管用。
