本文将客观、完整地讲解如何使用 Free Spire.PDF 实现 PDF 文本添加，从基础落地代码到进阶样式定制，适配各类 PDF 文本编辑需求。
一、环境准备
1.1 库安装
首先通过 pip 安装 Free Spire.PDF 依赖库，执行以下命令：
CB0
该库支持 Python3.7 及以上版本，兼容 Windows、Mac、Linux 多平台，安装后可直接调用 API 进行 PDF 编辑操作。
1.2 核心模块说明
本次实战核心依赖库内常用模块，提前说明核心作用：
- PdfDocument ：PDF 文档核心操作类，用于加载、保存、关闭文档
- 字体相关类 ：PdfCjkStandardFont、PdfTrueTypeFont、PdfFont，分别适配中文字体、系统自定义字体、内置标准字体
- PdfSolidBrush、PdfRGBColor ：用于设置文本绘制颜色、画刷样式
- PointF ：定义文本在 PDF 页面中的绘制坐标位置
二、基础实现：为 PDF 添加普通文本
基础场景实现加载已有 PDF 文件，在指定页面、指定坐标位置添加自定义文本，同时配置基础字体样式、颜色。以下是完整可运行代码，包含详细注释。
CB1
**代码核心逻辑** ：加载文档 → 选中目标页面 → 配置字体与颜色样式 → 定义绘制位置 → 绘制文本 → 保存并释放资源，流程简洁清晰，无冗余操作。
三、进阶样式定制
Spire.PDF 支持丰富的文本样式拓展，可灵活适配不同场景的排版需求，包括多类型字体、自定义颜色、文字透明度、文字旋转效果等，下面逐一讲解实战用法。
3.1 多字体与自定义颜色配置
库中提供三种主流字体创建方式，分别适配中文场景、系统第三方字体、PDF 内置标准字体，同时支持 RGB 任意自定义颜色。
CB2
其中 **嵌入字体** 可保证 PDF 在任意设备打开时，字体样式不会错乱，适合需要跨设备展示的文档。
3.2 文本透明度效果设置
通过画布的 SetTransparency 方法可实现文字透明效果，常用于制作轻量化水印、备注文本，透明度参数范围 0.0~1.0，0.0 为完全透明，1.0 为完全不透明。
CB3
3.3 文字旋转效果实现
支持通过画布旋转画布坐标系，实现任意角度的倾斜文字，常用于制作斜向水印、侧边标注文本，逆时针旋转参数为负数，顺时针为正数。
CB4
注意：画布旋转为全局生效，若需恢复默认角度，可在绘制完成后重置画布变换状态。
四、开发注意事项
- 资源释放 ：文档操作完成后必须调用 Close() 方法，释放文件资源，避免文件占用、内存溢出问题
- 坐标适配 ：PDF 坐标单位为磅，页面左上角为坐标原点，可根据页面尺寸灵活调整绘制位置
- 中文适配 ：中文文本优先使用 PdfCjkStandardFont 或系统中文字体，避免乱码、字体缺失问题
- 样式叠加 ：透明度、旋转、字体样式可自由组合，实现复杂的文本展示效果
五、总结
Spire.PDF for Python 提供了极简且强大的 PDF 文本编辑能力，无需复杂编码即可实现 **基础文本添加、多字体适配、自定义颜色、透明文本、旋转文字** 等常用功能。相比传统 PDF 处理库，其优势在于 API 通俗易懂、样式支持全面、兼容中英文场景，非常适合 PDF 自动化编辑、批量文档处理、水印生成等开发场景。