给 PDF 加页码：位置、起始号，以及旋转页的坑

添加页码会在 PDF 的每一页写上一个十进制数字。你能选的只有角落、字号和起始号，其余都是固定的。它不知道页面是否存储为旋转状态、封面该不该留空、页面上是否已经印有页码，这三件事都要你在上传前自己决定。

工具写进去的是什么

页码是加进页面内容的黑色 Helvetica 文字，所以任何查看器都能看到，打印也在，随文件走。字体和颜色没有选项。它也不是某些阅读器在缩略图栏里显示的页面标签，所以显示 “iii” 或 “A-1” 这类标签的查看器，仍然显示它自己的标签。

表单有三个设置：

• 位置： 左上、中上、右上、左下、中下、右下。表单默认中下。接口里这六个位置对应 1、2、3、7、8、9；4、5、6 把页码放在纵向正中的左、中、右。
• 起始号： 默认 1。第一页取这个值，之后每页加 1。
• 字号： 默认 12，表单范围 6 到 200。接口不强制这个范围，请自行保持在范围内。

起始号必须是整数：abc 会被拒绝，返回 400 invalid_parameter；负数可以接受，照原样写出（-2、-1、0、1……）。

页码的锚点距页面边缘 48 磅（三分之二英寸），按页面 MediaBox 的尺寸计算。数字从锚点开始向右书写，所以“中下”是数字的左端落在中线上，三位数会略偏右；“右下”从距右边缘 48 磅处起笔、向边缘方向延伸，12 磅的三位数大约止于距边缘 28 磅处。12 磅时不太看得出来。

一个完整例子：合同第二卷

有一份 6 页的 contract.pdf，接着 100 页的第一卷。把它上传到添加页码，起始号填 101，位置选右下，字号 12。2026-10-04 对本地构建的一次运行中，输出是 6 页的 PDF，提取文字后看到 101 到 106，各在对应页右下角、正文下方。不同查看器的渲染细节可能不同，顺序和数值不会变。

这个结果有两点要知道。输出沿用输入的文件名（contract.pdf），覆盖原件之前先改名。另外，接口请求不传 position 时，页码放在右上（值 3），不是表单的中下。脚本里请显式传 position。

装订一份材料时的操作次序

工具会给你上传的文件的每一页编号，不能跳过封面，也不能中途重新开始。所以先后次序决定结果：

页面上若已经印有页码，新页码是额外画上去的。对同一个文件运行两次，每页就有两个页码：测试中，第二遍用相同位置，新的 “1” 画在已有的 “101” 上，两者重叠。所以保留未编号的原件，每次都从它开始。

怎样把封面或某一段干净地切出去，以及被删掉的页面可能留下什么，见只发 PDF 的部分页面。

旋转页的坑

扫描仪和手机拍出来的页面，常常用旋转标记存储，而不是重新绘制。页码是按未旋转的页面定位的，所以存储为旋转 90 度的页面上，页码会落在错误的边缘并且横躺。测试中，一页标记为旋转 90 度的 Letter 页面，选“中下”编号后，显示为横向页面，左边缘中部出现一个很小的横躺的 “1”，而不是在底部。

能控制次序时，先编号，再用旋转。旋转作用于整页，页码会随文字一起转。如果文件拿到手时就带旋转标记，这个工具无法补偿，也没有可调的设置；编号之后请在查看器里检查这些页。

打印前检查

打开第一页、中间一页和最后一页。看数字有没有压在打孔边距、照片或已有文字的页脚上。末尾若有空白页，先删除页面再编号，最后一个页码才与最后一个有内容的页对应。页码已经是页面的一部分，之后用提取页面或调整顺序，页码仍跟着原来的页，序列就不再按次序排列；顺序变了，请从未编号的文件重新编号。

只给你有权修改的文档编号；归档流程要求保留未标记的源文件时，留好未编号的原件。带密码的文件需要密码：网页上会提示输入；接口不带密码调用会得到 400 password_required（“This PDF is password-protected. Enter its password.”），所以请先解锁。调用该工具不需要 API Key。