关于 PDF 页码工具
PDF 页码工具为文档批量添加或移除页码，支持选择位置、起始数字与字体样式，让合订本、报告或扫描归档拥有统一的页脚标识。实现上页码以文本对象叠加到 PDF 内容流之上，不修改或覆盖原始页面内容，因此文字层完整保留、便于后续检索。支持 6 种位置（底部居中、左下、右下、顶部居中、左上、右上）、阿拉伯/罗马/字母三种数字格式、可自定义前缀（如「第 X 页 / 共 Y 页」）并可跳过封面从指定页起算。几个实用经验：学术论文常用「封面目录不编号，正文才起算」，可设起始页码实现；合同引用多用「第 X 页 共 Y 页」方便对账；多份文档合订成册前应先统一编号体系，避免最终成品页码错乱。处理在浏览器本地用 WebAssembly 完成，文件内容不上传，比在线工具更可控，适合整理合同、论文、会议资料时快速规范页码。
页码与物理页序不是同一件事，这是加页码时最容易踩的坑。封面、目录与插页通常不参与正文编号，因此正文第一页显示的「一」在文件内部可能排在第五个位置。若工具按物理位置从第一页开始编号，正文页码会整体偏移，且偏移量在补充或删除前置页后会立刻变化。因此应先指定起始页与起始编号，再执行编号。
已有页码的处理需要额外判断，否则会出现两套编号叠加。扫描件本身可能印有无法去掉的页码，此时再加一层就会同时出现两个数字；而部分文档的页码藏在页眉页脚之外，位置靠近裁切边缘，容易被新的页码覆盖。因此在批量添加前应先抽看几页确认原有页码的位置与形式，再决定新页码放在哪一侧。
格式与字体的一致性比外观美观更影响可用性。新加的页码若与正文使用不同的字体或字号，在同一页上会显得突兀，而更实际的问题是某些阅读器在提取文本时会把不同字体的内容分块，使页码与正文在提取结果里分离。因此建议复用文档内已有字体的一个子集，至少在字号与位置对齐上保持一致。
编号范围的选择需要与文档结构配合。整份文档统一编号最简单，但若文档由若干独立章节合订而成，分章节各自编号更符合阅读习惯，代价是引用时要说清「第几章第几页」。因此在动手前应先确认文档的使用方式：是当作一个整体被引用，还是各章节独立流转，这决定了编号方案而不是偏好。
定位参数化的处理能让后续修改变得容易。页码的位置、边距与格式若在添加时以参数形式设定，日后调整只需重跑一次；而若手工逐页放置，任何改动都要重新做一遍。因此即使只是给一份文档加页码，也值得把参数记录下来，尤其是需要为多份文档保持统一风格时。
最后，添加页码会改变文件内容，因此在有数字签名或内容校验的文档上执行需要格外谨慎。任何内容变动都会使原有签名失效，即使只是加了一行页码；而若文档被执行过内容摘要比对，加页码后比对结果也会不一致。因此在这类文档上操作前，应先确认是否允许修改，必要时改为生成一份副本用于展示。
实现原理
添加页码是「在页面上绘制文字」的操作，因此需要决定三件事：起始编号（封面是否计入）、位置与格式、以及是否避开已有的页脚内容。要点是页码是绘制的图形而非文档结构，因此与阅读器自身显示的页码相互独立，两者不一致时需要人工核对。
封面不显示页码、正文从 1 开始需要对第一页跳过绘制、并从第二页起以 1 起始——若直接按物理页编号，正文会从 2 开始本页实测数据
| 页数保持 | 输入 3 页 → 输出 3 页（加页码不增删页） |
|---|---|
| 页码写入 | pypdf 抽取每页文本依次为 "1"、"2"、"3"——页码真的写进了页面内容流，不是叠加层或预览效果 |
| 端侧处理 | pdf-lib/pdf.js 在浏览器内完成，文件不上传（页面无上传接口） |
| 可配置 | 位置（左下/中/右、顶部）、字号、格式（1 / 1/n / page-1-of-n）、起始页四项可选 |
给 PDF 加页码看似简单，实际有三个坑：①已有页码的文档会叠字——扫描件或别人加过页码的 PDF，再加一次会出现两套数字，本页不做检测（需要先确认原文档）；②页码写进内容流而非注释——这样才能被打印、被文本抽取到（本页实测可抽取，说明是前者）；③起始页用于封面/目录不计页的情况，设置后第 2 页会显示 1。另外加密或带签名的 PDF 无法这样改写（签名会失效），需要原始未签名版本。
使用方法
- 打开「PDF 页码工具」
- 上传 PDF 文件
- 根据需要调整输出选项
- 点击「处理」按钮，结果实时显示
- 复制或导出结果
使用场景
- 学术论文页码 — 为毕业论文或期刊投稿添加规范的页码，封面页跳过从正文开始编号。
- 合同文档编号 — 为多页合同添加页码便于引用和核对，使用第 X 页共 Y 页格式。
- 报告排版 — 为季度报告、年度总结添加底部居中页码，提升文档专业感。
- 书籍排版 — 使用罗马数字为前言编页码，阿拉伯数字为正文编页码，符合出版规范。
- 会议材料 — 为会议手册或培训资料添加页码，方便参会者按页引用内容。
常见问题
能跳过封面页不加页码吗？
能。可设置起始页码页，前几页不加页码，从指定页开始编号，适合封面和目录不编号的排版需求。
支持哪些页码格式？
支持阿拉伯数字（1 2 3）、罗马数字（i ii iii）、字母（a b c）以及自定义前缀格式（如第 1 页 / 共 10 页）。
页码位置可以自定义吗？
可以。支持底部居中、左下角、右下角、顶部居中、左上角、右上角共 6 种位置选择。
会修改原始 PDF 内容吗？
不会。页码以文本对象叠加到 PDF 内容流之上，不修改或覆盖原始页面的任何内容，文字层仍可检索。
能同时用多种编号格式吗？
当前默认整份文档统一编号。若需要「前言用罗马、正文用阿拉伯」的分节编号，建议先把文档拆成两部分分别处理。
文件会被上传吗？
不会。所有页码添加操作在浏览器本地通过 pdf-lib 完成，文件不离开你的设备，可安全处理敏感文档。
页码从第二页开始编号怎么设？
用「起始页码」与「起始位置」两个参数组合：起始位置选第 2 页，起始页码填 1，这样封面不带页码、正文从 1 开始。若封面也要占位但不显示，则把封面页设为跳过。
加的页码位置和原有页码重叠？
先看原页码在哪个角落、什么字号，再把新页码放到对角或用边距把它挤开。若原页码是内容的一部分，遮挡不可避免，只能选择覆盖原页码（先删旧页码）或放在空白区域。