利用 Python 脚本结合 openpyxl 与 fpdf 库，可实现从 Excel 数据到 PDF 文档的批量自动化转换。文章详细阐述了环境配置、库安装、代码实现及常见问题处理，涵盖中文字体支持、图片路径管理及分页逻辑，旨在帮助技术人员快速掌握办公自动化技能，提升工作效率。
在办公场景中，经常需要将 Excel 表格中的数据批量转换为格式固定的 PDF 文档，例如员工工卡、合同书、报表等。手动操作不仅耗时且容易出错，而使用 Python 脚本可以实现自动化处理，大幅提升效率。
本文将以制作员工工卡为例，详细介绍如何利用 Python 的 openpyxl 库读取 Excel 数据，并结合 fpdf 库生成包含图片、文字和边框的 PDF 文档。通过本教程，读者可以掌握办公自动化的核心技能，将重复性劳动转化为代码执行。
确保已安装 Python 3.8 及以上版本。可以通过命令行输入 python --version 进行验证。
推荐使用 Visual Studio Code (VS Code) 作为编辑器，并安装 Python 插件以获得更好的代码提示和调试体验。
打开终端（Terminal），依次执行以下命令安装所需的第三方库：
pip install openpyxl
pip install fpdf
使用 load_workbook 函数加载 Excel 文件，获取工作表对象。通过遍历行和列，提取单元格中的文本内容（如姓名、部门）和图片文件名。
初始化 FPDF 对象，设置页面尺寸（如 A4）。利用 rect() 绘制边框，text() 或 cell() 输出文本，image() 插入图片。通过循环控制分页逻辑，当一页容纳的员工数量达到上限时，添加新页。
根据实际工卡设计图，计算坐标位置。注意中文字体的嵌入问题，因为 fpdf 默认不支持中文，需要指定 .ttf 字体文件。
假设 Excel 文件名为 employees.xlsx，第一行为标题，后续每行包含：姓名、职位、照片文件名。照片存放在 images/ 目录下。
from openpyxl import load_workbook
from fpdf import FPDF
import os
class EmployeeCardPDF(FPDF):
def header(self):
# 可选：在每个页面顶部添加统一信息
pass
def footer(self):
# 可选：在每个页面底部添加页码
self.set_y(-15)
self.cell(0, 10, f'Page {self.page_no()}', 0, 0, 'C')
def generate_pdf(excel_path, image_dir, output_path):
# 1. 加载 Excel 数据
wb = load_workbook(filename=excel_path)
ws = wb.active
# 2. 初始化 PDF 对象 (A4 尺寸，单位 mm)
pdf = EmployeeCardPDF()
pdf.add_page()
pdf.set_auto_page_break(auto=True, margin=15)
# 设置中文字体路径 (需确保该路径下存在对应的 .ttf 文件)
# 注意：fpdf 默认不支持中文，必须指定 font 参数
try:
pdf.add_font('SimHei', '', 'path/to/simhei.ttf', uni=True)
pdf.set_font('SimHei', size=12)
except Exception as e:
print(f"字体加载失败：{e}")
return
row_count = 0
employees_per_page = 6 # 每页放置 6 个员工
for row in ws.iter_rows(min_row=2, values_only=False): # 跳过标题行
name_cell = row[0].value
pos_cell = row[1].value
img_name = row[2].value
if not name_cell:
continue
# 如果当前页已满，添加新页
if row_count > 0 and row_count % employees_per_page == 0:
pdf.add_page()
# 重置字体以防万一
pdf.set_font('SimHei', size=12)
# 计算当前位置 (简单网格布局示例)
# 这里需要根据实际设计调整坐标
x_pos = 20 + (row_count % 3) * 90
y_pos = 20 + (row_count // 3) * 120
pdf.set_xy(x_pos, y_pos)
# 绘制工卡边框
pdf.rect(x_pos, y_pos, 80, 110, style='D')
# 插入员工照片
img_path = os.path.join(image_dir, str(img_name))
if os.path.exists(img_path):
pdf.image(img_path, x=x_pos + 10, y=y_pos + 10, w=60, h=70)
else:
pdf.text(x_pos + 10, y_pos + 10, "No Photo")
# 输出姓名
pdf.set_xy(x_pos + 10, y_pos + 85)
pdf.cell(60, 10, txt=f"姓名：{name_cell}", ln=0, align='L')
# 输出职位
pdf.set_xy(x_pos + 10, y_pos + 95)
pdf.cell(60, 10, txt=f"职位：{pos_cell}", ln=0, align='L')
row_count += 1
# 保存 PDF 文件
pdf.output(output_path)
print(f"成功生成 {output_path}，共处理 {row_count} 条记录。")
if __name__ == '__main__':
generate_pdf(
excel_path='employees.xlsx',
image_dir='images',
output_path='employee_cards.pdf'
)
fpdf 默认仅支持标准英文字体。若需输出中文，必须预先注册字体文件。步骤如下：
add_font() 方法注册字体。set_font() 中指定字体名称。使用 os.path.join 拼接路径可避免跨平台兼容性问题。务必检查图片是否存在，避免因缺失导致程序中断。
通过计数器 row_count 判断当前页是否已满。当满足条件时调用 pdf.add_page() 切换页面，并重置坐标偏移量。
对于大量数据（如超过 1000 人），建议分批处理或使用流式写入，避免内存占用过高。同时，压缩图片大小可减小最终 PDF 体积。
A: 确认字体文件路径正确，且 add_font 中的 uni=True 参数已启用。部分旧版 fpdf 可能不支持 Unicode，建议升级到最新版或使用 reportlab 替代。
A: 检查图片格式是否为 JPEG 或 PNG，并确保路径字符串无特殊字符。Windows 系统下注意反斜杠转义。
A: 修改 x_pos 和 y_pos 的计算公式。可以使用 get_string_width() 测量文本宽度以动态对齐。
除了员工工卡，此技术栈还可应用于：
通过结合 openpyxl 和 fpdf，Python 能够高效完成从结构化数据到格式化文档的转换。这种自动化方案不仅减少了人工错误，还显著提升了办公效率。开发者可根据实际需求灵活调整布局和功能，构建更复杂的文档生成系统。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online