
使用 borb 创建 pdf 时,`document` 对象没有 `append_page()` 方法,正确方法是调用 `add_page()`;同时需注意 `page` 类应直接从 `borb.pdf` 导入,而非子模块。
在 borb 库(v3.x 及以上版本)中,Document 类的页面添加接口已统一为 add_page(),而非旧版文档或误传的 append_page()。该错误通常源于 API 版本更新导致的方法名变更,或对导入路径的误解。
✅ 正确用法如下:
from borb.pdf import Document, Page # 创建空 PDF 文档 pdf = Document() # 创建新页面(可选:指定尺寸,如 Page(595, 842) 表示 A4) page = Page() # ✅ 使用 add_page() 添加页面(注意:不是 append_page) pdf.add_page(page)
⚠️ 注意事项:
- 导入路径必须准确:Page 类位于 borb.pdf 模块顶层,不应写成 from borb.pdf.page.page import Page —— 后者在新版 borb 中不存在,会导致 ImportError 或隐式行为异常。
- 方法名区分大小写且不可拼错:add_page 是唯一有效方法,append_page、addPage、add_page_ 等均无效。
- 页面对象需显式创建并传入:add_page() 接收一个 Page 实例,不支持无参调用或直接传入尺寸元组。
- 若需批量添加多页,可循环调用 add_page():
for _ in range(3):
pdf.add_page(Page())? 小贴士:可通过 help(Document.add_page) 或查阅 官方 GitHub 文档 确认最新 API。安装时建议使用稳定版本:pip install borb(避免使用带 -dev 的预发布版,除非明确需要实验特性)。
掌握这一基础操作后,即可继续向页面添加文本、表格、图像等元素,构建完整 PDF 内容。










