PDF 添加页码

关于 GeekFormat

上传一份 PDF，先选 9 宫格位置再选格式模板，起始页和颜色按需调，合同、报告、教材的页码几秒搞定。

什么是 PDF 页码？

PDF 页码（Page Number）是添加在 PDF 页面固定位置的页码标记。它和页面的物理位置不同，是叠加在页面上的注释或文本内容，常以「第 X 页」「X / Y」「- X -」「Page X」等格式出现。

**为什么需要专业工具？** PDF 阅读器在底部状态栏显示当前页号，但这部分无法打印，且不能复制给同事。加上 PDF 页码后，无论打印还是复制，页码都随文档走。

**和「页码总数」的区别：** 真实页码是「当前页 / 总页数」。本工具可以在格式字符串中嵌入两个变量，自动算出「第 X 页 / 共 Y 页」这样的表达。

**核心参数：** 起始页（1 还是自定义）、位置（9 宫格九种位置）、格式（第 X 页 / 共 Y 页 / X / Y / - X -）、字体（思源黑体）、颜色（HEX）。

**典型场景：** 合同装订前需要自动生成页码、长报告打印刷页用、教材添加章节统一编号。

适用场景

合同装订前需要自动生成页码
长报告打印刷页用，方便引用特定页
教材添加章节统一编号
PPT 转 PDF 后加页码便于讨论时定位
论文 / 学术材料加页码便于审阅
项目文档加页码便于交叉引用

使用方法

上传需要加页码的 PDF 文件
选择页码位置（左下 / 中下 / 右下等）
设置格式字符串、起始页、字体字号颜色
点击生成页码并下载 PDF

功能特点

9 种位置布局：3×3 九宫格（左上 / 中上 / 右上 / 左中 / 正中 / 右中 / 左下 / 中下 / 右下）
4 种格式模板：内置「纯数字」「第 N 页」「N / P」「自定义」
起始页自定义：可设为 1 或任意数字（合同封面、书籍章节常用）
自定义格式字符串：支持 {n} 和 {p} 占位符，自定义前缀后缀
页码范围可选：全部页 / 自定义起始-结束范围
3 档边距：窄（15px）/ 推荐（30px）/ 宽（50px）
字体颜色可调：内置中文字体（思源黑体）+ HEX 颜色选择器
纯前端本地处理：基于 pdf-lib 浏览器内完成，文件不上传

PDF 加页码 vs Word 自动页码 vs 手动打印

PDF 加页码有三种思路，本工具属于「事后添加」型，是拿到现成 PDF 后最常用的方式。先看自己处于哪种场景，再选最合适的路径。

PDF 加页码 vs Word/Pages 自动页码 vs Acrobat 编辑：怎么选？

三种方式都能给文档加页码，但代价和适用场景完全不同。

方式	适合场景	代价	推荐度
本工具 PDF 加页码	已有一份 PDF 文件（扫描件、合同、报告），需要永久加页码	上传 PDF → 选位置和格式 → 下载，几秒完成	✅ 首选
Word/Pages 自动页码	源文件还在 Word/Pages/Excel 里，能在编辑时插入页码	需要打开源文件，在「插入 → 页码」设置位置和格式	⚠️ 仅当源文件方便拿到
Adobe Acrobat 编辑	需要复杂页码逻辑（如章节独立编号、罗马数字 + 阿拉伯数字混用）	需要付费 Acrobat Pro，操作复杂	⚠️ 仅当企业级需求

本工具 4 种格式模板对比

4 种格式模板覆盖大部分文档类型，按文档用途选模板最快。

格式模板	示例输出	典型场景
`{n}`	1, 2, 3, ...	纯数字编号、简洁文档
`第 {n} 页`	第 1 页	中文文档、合同
`第 {n} 页 / 共 {p} 页`	第 5 页 / 共 30 页	学术论文、长报告
`{n} / {p}`	5 / 30	技术文档、英文报告

最佳实践

先选位置再选格式，避免来回切换

页码添加流程是「选位置 → 选格式 → 设起始页 → 选颜色 → 下载」。**位置一旦选错，所有页都跟着错**。先想清楚页码放哪里（常用中下），再选格式（中文「第 N 页」或英文「N / P」）。**不要边选边换格式**，每换一次格式字符串所有页码都要重画。中文文档建议「中下 + 第 N 页 + 黑色 + 起始页 1」这套默认值先试，满意后再调其他参数。

起始页设为 1 时合同封面也算页 1，不要混淆页码和物理页

**页码起始页 ≠ PDF 物理页位置**。本工具的「起始页」是「页码文本上显示的数字」，PDF 的「物理页」是文件里第几页（从 1 计数）。如一份合同是 5 页：物理页 1 = 封面、2 = 目录、3-5 = 正文。**想让正文页码从 1 开始**：保留「起始页 = 1」但用「自定义页码范围」设为 3-5，或用 Word 重新生成。如想让封面 = 页 1、目录 = 页 2、正文 = 页 3：保留默认全部应用 + 起始页 1。**判断失误会让审阅人读错页**。

自定义格式字符串用 {n} 和 {p} 占位，别用 {page} 或 {total}

本工具的自定义格式字符串只识别两个占位符：**`{n}` 代表当前页号，`{p}` 代表总页数**。其他占位符如 `{page}` `{total}` `{number}` `{count}` 都会原样显示成文字，不会被替换。常用格式示例：「Page {n} of {p}」、「第 {n} / 共 {p} 页」、「- {n} -」。**改完字符串先在设置面板预览一下**，再下载 PDF，避免下完才发现格式不对要重来。

中文文档确认思源黑体已加载，否则中文页码会变方框

本工具默认嵌入思源黑体（SourceHanSansCN-Normal.ttf）显示中文页码。**思源黑体需从站内 `/SourceHanSansCN-Normal.ttf` 路径加载**，如果断网、跨域或部署路径错误，会静默回退到 Helvetica 英文渲染，**中文页码全部显示为方框**。处理方式：1）确认浏览器能访问 `/SourceHanSansCN-Normal.ttf`；2）下完 PDF 后立刻打开看中文页码是否正确，不要只信任下载成功提示。如确认断网，建议用本工具加完页码后再下载，或者改用纯数字格式（如 `{n}`）避开中文。

只想给部分页加页码时用「自定义范围」，不要手动上传分割 PDF

「只想给正文加页码、跳过封面和目录」是常见需求。**不要先把 PDF 拆成两半再上传本工具**——拆分后再合并会丢字体、丢链接、破坏目录书签。**正确做法**：在「页码范围」选「自定义」，输入「起始页 = 3」「结束页 = 30」（对应正文物理页位置），工具只处理该范围的页面，封面和目录保持原样。一次操作完成，比拆 PDF 再合并高效很多。

下载后立刻打开验证页码，不要只信任「下载成功」提示

工具会弹出「添加成功」提示，但**这不代表页码一定正确**。下载完成后**立刻在浏览器或 PDF 阅读器中打开**检查三件事：1）中文页码是否显示为文字（不是方框）；2）起始页数字是否符合预期（不是从 0 或 2 开始）；3）位置是否正确（不是跑到页面中间）。**发现问题立刻重新调整参数再生成一次**，比交出去后被对方指出错误更省事。这一步不要跳过。

已有页码的 PDF 想替换，先去掉旧页码再重新加

本工具**不识别或删除 PDF 中已有的页码**。如已有页码的 PDF 想换成新格式（如把「第 5 页」改成「5 / 30」），**直接加新页码会两层重叠显示**，非常难看。处理顺序：先用 `/pdf/edit/` 编辑原 PDF 手动删除旧页码 → 再用本工具加新页码。或者接受旧页码的存在，重新生成的 PDF 用 `/pdf/compress/` 压缩一次（压缩不一定能去掉旧页码）。**没有「覆盖」式替换功能**，必须在编辑环节先清理。

常见问题

PDF 自动页码支持哪些格式？

本工具内置 4 种格式模板：纯数字「第 N 页」、「N / P」、「自定义」字符串。可自定义格式字符串，通过 {n} 占位当前页、{p} 占位总页数。

起始页可以不是 1 吗？

可以。如合同常用「封面 = 页 1」，本工具允许起始页为任意数字（默认 1，可改为 0、5、10 等）。如要从封面之外开始计数，把「起始页」设为对应数字即可。

页码颜色怎么改？

点击页码设置面板的颜色选择器（黑色方块图标），弹出 HEX 颜色选择面板，输入或拖动选颜色即可。颜色会应用到所有页码。

PDF 页码是文本还是图像？

是文本。本工具使用 pdf-lib 的 drawText 把页码作为矢量文本绘制到 PDF 页面内容流，可被选择 / 复制 / 搜索，体积变化极小（每页增加几个字符字节）。

PDF 页码会影响打印吗？

会。本工具的页码作为内容流的一部分嵌入 PDF，打印时一起打印。如需打印时隐藏，可配合 /pdf/encrypt/ 的「禁止打印」权限使用。

起始页和 PDF 阅读器底部的页号不一致？

PDF 阅读器底部的页号是物理页（从 1 开始计数），不可修改。本工具的页码是叠加在内容上的文本，按你设置的「起始页」独立计数。两者并存，互不影响。

怎么只在奇数页或偶数页加页码？

本工具暂不支持单独奇偶页设置，所有页统一应用页码。如需只在部分页加，可使用「自定义页码范围」模式：手动输入起始和结束页码，工具只处理该范围内的页面。