2. 环境搭建与依赖安装：Python环境、Pillow库、ReportLab库、OpenPyXL库的安装与验证

做批量证书生成，说白了就是让代码替我们干重复的体力活。但工欲善其事，必先利其器。环境搭不好，后面全是坑。我个人习惯先把基础环境理清楚，再动手写代码。这一章我们就来搞定 Python 环境，以及三个核心库的安装与验证。

2.1 Python 环境准备

我建议你直接用 Python 3.8 以上版本。为什么？因为 Pillow 和 ReportLab 在 3.8 之后的支持最稳定。我曾经在 Python 3.6 上踩过坑，有个库的旧版本死活装不上，后来发现是 Python 版本太老，升级后一次过。

你可以去 python.org 下载安装包。安装时记得勾选「Add Python to PATH」，这个选项很多人会忽略，结果在命令行里打不出 python 命令，又得重装一遍。

小技巧： 安装完成后，打开终端（Windows 用 cmd 或 PowerShell，Mac/Linux 用 Terminal），输入以下命令验证： 
python --version
pip --version

如果看到类似 Python 3.10.12 和 pip 23.0.1 的输出，说明环境就绪了。嗯，这里要注意：如果系统同时装了 Python 2，可能需要用 python3 和 pip3 来区分。

2.2 三大核心库简介

我们这门课要用到三个库，各司其职。我整理了一张表，方便你对照理解：

库名 用途 典型场景
Pillow 图像处理 打开背景图、粘贴头像、调整尺寸、添加文字
ReportLab PDF 生成 创建证书 PDF、排版文字、嵌入图片、设置页面尺寸
OpenPyXL Excel 读写 读取学员名单、解析模板数据、导出批量信息

你想想看，这三个库正好覆盖了证书生成的完整链路：从数据源（Excel）到图像处理（Pillow），再到最终输出（PDF）。少了任何一个，流程都跑不通。

2.3 安装依赖库

安装过程其实很简单，一行命令搞定。但我建议你用一个干净的虚拟环境，避免和系统其他项目冲突。我个人习惯用 venv，Python 自带的，不用额外装东西。

2.3.1 创建虚拟环境（推荐）

# 创建虚拟环境
python -m venv cert_env

# 激活虚拟环境
# Windows:
cert_env\Scripts\activate
# Mac/Linux:
source cert_env/bin/activate

激活后，终端前面会出现 (cert_env) 字样，说明你已经在虚拟环境里了。这时候安装的库不会影响全局。

2.3.2 安装 Pillow

pip install Pillow

Pillow 是 PIL（Python Imaging Library）的活跃分支。我记得早期用 PIL 时，它已经好几年没更新了，连 Python 3 都不支持。后来社区 fork 出了 Pillow，才让图像处理在 Python 3 上活过来。

2.3.3 安装 ReportLab

pip install reportlab

ReportLab 是 PDF 生成领域的老牌库。它的 platypus 模块提供了段落、表格、图片等高级排版能力，非常适合做证书这种固定模板的文档。

2.3.4 安装 OpenPyXL

pip install openpyxl

OpenPyXL 专门处理 .xlsx 文件。它支持读取、写入、修改样式，甚至能操作图表。我们主要用它来读取 Excel 中的学员数据。

2.3.5 一键安装（省事版）

你也可以把三个库写在一个文件里，一次性安装：

pip install Pillow reportlab openpyxl
注意： 如果安装速度很慢，可以加上国内镜像源，比如： pip install Pillow reportlab openpyxl -i https://pypi.tuna.tsinghua.edu.cn/simple

2.4 验证安装是否成功

安装完别急着走，一定要验证一下。我曾经遇到过 pip 显示安装成功，但实际导入时报错的情况——后来发现是网络问题导致下载的包不完整。

写一个简单的 Python 脚本，分别导入三个库并打印版本号：

# check_env.py
import sys
print(f"Python 版本: {sys.version}")

try:
    from PIL import Image
    print(f"Pillow 版本: {Image.__version__}")
except ImportError:
    print("Pillow 安装失败")

try:
    from reportlab import Version
    print(f"ReportLab 版本: {Version}")
except ImportError:
    print("ReportLab 安装失败")

try:
    import openpyxl
    print(f"OpenPyXL 版本: {openpyxl.__version__}")
except ImportError:
    print("OpenPyXL 安装失败")

运行这个脚本：

python check_env.py

如果看到类似下面的输出，说明环境搭建完成：

Python 版本: 3.10.12 (main, Nov 20 2023, 15:14:05) [GCC 11.4.0]
Pillow 版本: 10.2.0
ReportLab 版本: 4.0.8
OpenPyXL 版本: 3.1.2
核心要点： 版本号可能不同，但只要能正常导入并打印出版本，就说明库已经可用。如果某个库报错，先检查网络，再尝试重新安装。

2.5 本章知识体系

下面这张图帮你梳理了本章的核心逻辑：从 Python 环境出发，经过三个库的安装与验证，最终进入证书生成实战。你可以把它当作一张路线图。

环境搭建知识体系图 环境搭建与依赖安装 · 知识体系 Python 3.8+ 环境 Pillow · 图像处理 ReportLab · PDF 生成 OpenPyXL · Excel 读写 打开背景图 粘贴头像 添加文字 调整尺寸 创建 PDF 排版文字 嵌入图片 设置页面 读取名单 解析模板 导出数据 修改样式 验证安装 → 进入实战 pip install 一键安装

2.6 常见问题与避坑指南

  • pip 版本过旧： 安装前建议先升级 pip：python -m pip install --upgrade pip。我曾经因为 pip 版本太旧，装 Pillow 时一直报 Could not find a version that satisfies the requirement，升级后就好了。
  • 虚拟环境未激活： 如果你在虚拟环境外安装了库，换到虚拟环境里会找不到。每次打开终端，记得先激活虚拟环境。
  • 权限问题： Linux/Mac 下如果遇到权限错误，可以加 --user 参数：pip install --user Pillow。但我更推荐用虚拟环境，省心。
  • 网络超时： 国内用户建议用镜像源，速度能快几十倍。我一般用清华源，稳定且更新及时。
避坑提醒： 不要用 sudo pip install（Linux/Mac）或以管理员身份运行（Windows）来安装库。这可能会破坏系统 Python 环境。虚拟环境是最安全的选择。

好了，环境搭建就到这里。三个库装好、验证通过后，你就可以放心地进入下一阶段了。记住：环境是地基，地基稳了，后面的代码才能跑得顺畅。

← 上一章 📖 返回目录 下一章 →