### 关于 Python 库 fpdf2 的使用教程 `fpdf2` 是一个用于生成 PDF 文档的轻量级 Python 库，其设计目标是简化 PDF 创建过程并提供易用性。下面详细介绍 `fpdf2` 的基本功能以及如何通过示例代码实现 PDF 文件的生成。 #### 安装 fpdf2 在开始之前，需要安装 `fpdf2` 库。可以通过以下命令完成安装： ```bash pip install fpdf2 ``` --- #### 基本概念与初始化 `fpdf2` 提供了一个名为 `FPDF` 的类来表示 PDF 文档对象。该类允许开发者定义页面布局、字体样式以及其他文档属性。以下是创建 PDF 对象的基本流程： 1. **导入模块** 导入 `fpdf` 模块中的 `FPDF` 类。 2. **实例化对象** 初始化一个 `FPDF` 实例以代表新的 PDF 文档。 3. **添加页面** 使用 `.add_page()` 方法向文档中添加新页。 4. **设置字体** 使用 `.set_font(family, style=None, size=0)` 设置当前页面使用的字体及其大小。 5. **写入内容** 利用 `.cell(w, h=0, txt='', border=0, ln=0, align='', fill=False, link='')` 或其他方法，在指定位置绘制文字或其他图形元素。 6. **保存文件** 调用 `.output(name='-', dest='F')` 将最终结果导出到本地磁盘上的文件。 --- #### 示例代码：生成包含 “Hello World” 的 PDF 文件 以下是一个完整的例子，展示如何利用 `fpdf2` 构建一份基础 PDF 并输出至硬盘[^2]。 ```python from fpdf import FPDF # 创建一个新的 PDF 对象 pdf = FPDF() # 添加一页纸 pdf.add_page() # 配置默认字体为 Helvetica 字体，字号设为 12pt pdf.set_font("helvetica", size=12) # 向 PDF 中插入一段文本 "Hello World" pdf.cell(0, 10, text="Hello World", ln=True, align="C") # 输出生成好的 PDF 至 hello_world.pdf 文件 pdf.output("hello_world.pdf") ``` 此脚本会生成一个命名为 `hello_world.pdf` 的文件，并在其首页中央显示字符串 `"Hello World"`。 --- #### 进阶特性 除了上述的基础操作外，`fpdf2` 支持更多高级选项，比如自定义页面尺寸、旋转角度调整、嵌入图片资源等。下述片段展示了部分扩展能力： ##### 插入图像 可以借助 `.image(file, x=None, y=None, w=0, h=0, type='', link='')` 函数加载外部图片素材进入文档内部。 ```python pdf.image("example.jpg", x=10, y=8, w=100) ``` ##### 多种字体支持 如果希望切换不同类型的字型，则需调用多次 `.set_font()` 来更改相应参数配置。 ```python pdf.set_font("times", style="B", size=14) # Times New Roman 加粗风格 pdf.cell(0, 10, text="Bold Text Example", ln=True) ``` ##### 自动分页机制 当现有空间不足以容纳全部数据时，可通过启用自动换行模式解决这一问题。 ```python pdf.multi_cell(0, 10, """This is a long paragraph that will automatically wrap onto multiple lines as needed.""") ``` --- ### 总结 综上所述，`fpdf2` 不仅能够满足日常制作简单报表的需求，还具备一定的灵活性应对复杂场景下的定制开发任务。它凭借直观的操作接口降低了入门门槛，非常适合初学者尝试探索自动化办公解决方案领域内的可能性[^3]。