使用 Go 语言生成样式美观的 PDF 文件

文章精选推荐

1 JetBrains Ai assistant 编程工具让你的工作效率翻倍
2 Extra Icons：JetBrains IDE的图标增强神器
3 IDEA插件推荐-SequenceDiagram，自动生成时序图
4 BashSupport Pro 这个ides插件主要是用来干嘛的？
5 IDEA必装的插件：Spring Boot Helper的使用与功能特点
6 Ai assistant ,又是一个写代码神器
7 Cursor 设备ID修改器，你的Cursor又可以继续试用了

文章正文

使用 Go 语言生成样式美观的 PDF 文件是一个常见的需求，尤其是在报告生成、发票、合同等场景中。

幸运的是，Go 语言有几个强大的库，可以帮助开发者快速生成美观的 PDF 文件。

最常用的库之一是 github.com/jung-kurt/gofpdf，它提供了丰富的 API 来创建各种格式的 PDF 文件。

1. 安装 `gofpdf`

首先，你需要安装 gofpdf 库。可以使用 go get 来安装它：

go get -u github.com/jung-kurt/gofpdf

2. 使用 `gofpdf` 生成 PDF

gofpdf 提供了一个简单的 API 来生成 PDF 文件。你可以定义页面的尺寸、字体、颜色、边距等，还可以插入文本、图片、表格等内容。

2.1 创建一个基本的 PDF 示例

package main

import (
	"github.com/jung-kurt/gofpdf"
	"os"
)

func main() {
	// 创建一个新的 PDF 对象
	pdf := gofpdf.New("P", "mm", "A4", "") // P: 纵向，mm: 毫米单位，A4: 页面大小

	// 添加一页
	pdf.AddPage()

	// 设置字体
	pdf.SetFont("Arial", "B", 16)

	// 写入标题
	pdf.Cell(40, 10, "Hello, Go PDF!")

	// 输出到文件
	err := pdf.OutputFileAndClose("output.pdf")
	if err != nil {
		panic(err)
	}
}

2.2 设置字体和样式

你可以设置不同的字体、大小、颜色等。

package main

import (
	"github.com/jung-kurt/gofpdf"
	"os"
)

func main() {
	pdf := gofpdf.New("P", "mm", "A4", "")

	// 添加一页
	pdf.AddPage()

	// 设置字体为 Arial，常规样式，大小为 14
	pdf.SetFont("Arial", "", 14)

	// 设置字体颜色为蓝色
	pdf.SetTextColor(0, 0, 255)

	// 写入文本
	pdf.Cell(40, 10, "This is a blue text.")

	// 设置字体为 Times New Roman，粗体，大小为 12
	pdf.SetFont("Times", "B", 12)
	pdf.SetTextColor(255, 0, 0) // 红色
	pdf.Ln(10)
	pdf.Cell(40, 10, "This is a red bold Times font text.")

	// 输出 PDF 到文件
	err := pdf.OutputFileAndClose("styled_output.pdf")
	if err != nil {
		panic(err)
	}
}

2.3 添加图片

你还可以在 PDF 中插入图片。gofpdf 支持 JPEG、PNG 和 GIF 格式的图片。

package main

import (
	"github.com/jung-kurt/gofpdf"
)

func main() {
	pdf := gofpdf.New("P", "mm", "A4", "")

	// 添加一页
	pdf.AddPage()

	// 插入图片
	// 参数: 图片文件路径, x 坐标, y 坐标, 宽度, 高度
	pdf.Image("example.jpg", 10, 10, 50, 50)

	// 输出到文件
	err := pdf.OutputFileAndClose("image_output.pdf")
	if err != nil {
		panic(err)
	}
}

2.4 表格和复杂布局

gofpdf 也支持创建表格，以下是一个简单的表格生成示例：

package main

import (
	"github.com/jung-kurt/gofpdf"
)

func createTable(pdf *gofpdf.Fpdf) {
	// 设置字体
	pdf.SetFont("Arial", "B", 12)

	// 表头
	headers := []string{"ID", "Name", "Age"}
	for _, header := range headers {
		pdf.Cell(40, 10, header)
	}
	pdf.Ln(10) // 换行

	// 表格内容
	data := [][]string{
		{"1", "Alice", "23"},
		{"2", "Bob", "30"},
		{"3", "Charlie", "25"},
	}

	for _, row := range data {
		for _, cell := range row {
			pdf.Cell(40, 10, cell)
		}
		pdf.Ln(10) // 换行
	}
}

func main() {
	// 创建 PDF 对象
	pdf := gofpdf.New("P", "mm", "A4", "")

	// 添加一页
	pdf.AddPage()

	// 创建表格
	createTable(pdf)

	// 输出到文件
	err := pdf.OutputFileAndClose("table_output.pdf")
	if err != nil {
		panic(err)
	}
}

2.5 添加页脚和页码

在多页文档中，你可能希望添加页脚或页码。可以通过自定义函数来实现这一点。

package main

import (
	"github.com/jung-kurt/gofpdf"
)

func addFooter(pdf *gofpdf.Fpdf) {
	// 设置字体
	pdf.SetFont("Arial", "I", 8)

	// 设置位置
	pdf.SetY(-15) // 距离页面底部 15mm

	// 页脚内容
	pdf.Cell(0, 10, "Page "+strconv.Itoa(pdf.PageNo()), 0, 0, "C")
}

func main() {
	pdf := gofpdf.New("P", "mm", "A4", "")

	// 添加一页
	pdf.AddPage()

	// 设置正文内容
	pdf.SetFont("Arial", "", 12)
	pdf.Cell(40, 10, "This is a PDF with a footer!")

	// 添加页脚
	addFooter(pdf)

	// 输出 PDF
	err := pdf.OutputFileAndClose("footer_output.pdf")
	if err != nil {
		panic(err)
	}
}

2.6 更多样式和布局

gofpdf 还支持很多其他功能，比如：

设置不同的对齐方式（左对齐、居中、右对齐）
设置边框
使用矢量图形（线条、矩形、圆形）
动态内容的生成
多语言支持（如中文，需要设置支持的字体）

2.7 中文支持

Go 的 gofpdf 库原生不支持中文字符，但你可以通过加载 TTF 字体文件来支持中文字符。

首先，确保你有一个支持中文的 TTF 字体文件（例如，SimHei.ttf）。

package main

import (
	"github.com/jung-kurt/gofpdf"
	"log"
)

func main() {
	// 创建一个新的 PDF 对象
	pdf := gofpdf.New("P", "mm", "A4", "")

	// 添加页面
	pdf.AddPage()

	// 添加中文字体
	err := pdf.AddTTFFont("simhei", "./SimHei.ttf")
	if err != nil {
		log.Fatal(err)
	}

	// 设置字体
	pdf.SetFont("simhei", "", 14)

	// 写入中文内容
	pdf.Cell(40, 10, "你好，Go PDF!")

	// 输出到文件
	err = pdf.OutputFileAndClose("chinese_output.pdf")
	if err != nil {
		log.Fatal(err)
	}
}