pdfcpu命令速查表
2026-09-08 / Anan
pdfcpu 命令速查表
本文档只列常用命令、参数与用途，方便快速查阅。
常用命令一览
| 命令 | 参数示例 | 用途 |
|---|---|---|
pdfcpu lsinfo |
pdfcpu -w ./docs lsinfo example.pdf |
列出 PDF 基本信息：页尺寸、页数、版本 |
pdfcpu impinfo |
pdfcpu -w ./docs impinfo input.pdf |
列出导入过滤器信息（字体、图像、编码器） |
pdfcpu pages |
pdfcpu pages input.pdf [start] [stop] [-o out.pdf] |
显示或提取指定页码范围 |
pdfcpu addpage |
pdfcpu addpage [-s N] input.pdf [page...] -o out.pdf |
在指定位置插入空白页（N=位置，-1=末尾） |
pdfcpu delpage |
pdfcpu delpage [-s N] input.pdf [page...] -o out.pdf |
删除指定页码的页面 |
pdfcpu replacepage |
pdfcpu replacepage input.pdf replace.pdf -o out.pdf |
用另一 PDF 的页面替换当前页 |
pdfcpu replacepageall |
pdfcpu replacepageall input.pdf replace.pdf -o out.pdf |
用另一 PDF 的全部页面替换当前页 |
pdfcpu rotate |
pdfcpu rotate [-a 90|180|270] [-s N] [-f] input.pdf -o out.pdf |
旋转页面，-a 全部、-s 指定页、-f 横向翻页 |
pdfcpu background |
pdfcpu background [-a | -s N] [-f] input.pdf bg.pdf -o out.pdf |
设置背景（-a 全部页、-s 指定页） |
pdfcpu stamp |
pdfcpu stamp [-c|-w|-t|-l|-i] [-s N] [-f] input.pdf stamp.pdf -o out.pdf |
叠加印章/水印页面 |
pdfcpu encrypt |
pdfcpu encrypt [-p pwd] [-enc AES-256|AES-128|RC4-128] input.pdf -o out.pdf |
加密 PDF |
pdfcpu decrypt |
pdfcpu decrypt [-p pwd] input.pdf -o out.pdf |
解密 PDF |
pdfcpu encryptinfo |
pdfcpu encryptinfo [-u userpwd] [-o ownerpwd] [-enc ...] input.pdf -o out.pdf |
修改加密权限与所有者密码 |
pdfcpu permissions |
pdfcpu permissions [-a|-r|-w|-n|-p|-e|-t|-c] input.pdf -o out.pdf |
设置用户权限：打印/复制/修改/填表等 |
pdfcpu info |
pdfcpu info input.pdf |
显示完整的文档/页/字体/加密信息 |
pdfcpu listfonts |
pdfcpu listfonts input.pdf |
列出文档中使用的所有字体 |
pdfcpu listxref |
pdfcpu listxref input.pdf |
列出 xref 表中的条目 |
pdfcpu listimages |
pdfcpu listimages input.pdf |
列出文档中所有图片 |
pdfcpu listoutlines |
pdfcpu listoutlines input.pdf |
列出书签/大纲结构 |
pdfcpu merge |
pdfcpu merge [-o out.pdf] input1.pdf input2.pdf ... |
合并多个 PDF |
pdfcpu split |
pdfcpu split [-i] [-p N] input.pdf -o out.pdf |
拆分为每页一个文件，-i 按书签分块 |
pdfcpu pdfinfo |
pdfcpu pdfinfo input.pdf |
显示 PDF 元数据（标题、作者、关键字等） |
pdfcpu setpdfinfo |
pdfcpu setpdfinfo -t title -a author input.pdf -o out.pdf |
修改 PDF 元数据 |
pdfcpu setpagedelay |
pdfcpu setpagedelay [-a|-s N] N input.pdf -o out.pdf |
设置页面过渡延迟（毫秒） |
pdfcpu addoutputintent |
pdfcpu addoutputintent input.pdf iccfile.pdf -o out.pdf |
添加 ICC 色彩输出意图 |
pdfcpu setcolor |
pdfcpu setcolor [-a|-s N] r g b input.pdf -o out.pdf |
设置背景颜色（0-1 浮点） |
pdfcpu validate |
pdfcpu validate input.pdf |
校验 PDF 结构是否合规 |
pdfcpu repair |
pdfcpu repair input.pdf -o out.pdf |
修复有问题的 PDF |
pdfcpu convert |
pdfcpu convert -pdf2img|-img2pdf input.pdf -o out |
PDF 与图片互转 |
pdfcpu checkgofmt |
pdfcpu checkgofmt |
检查 gofmt 格式（Go 开发用） |
常用参数速查
| 参数 | 含义 |
|---|---|
-w <dir> |
指定工作目录 |
-o <file> |
输出文件 |
-s <n> |
指定页码（可多个） |
-a |
作用于全部页面 |
-f |
翻页/横向操作（rotate 等） |
-p <pwd> |
用户密码（password） |
-o <pwd> |
所有者密码（owner） |
-enc <type> |
加密算法：AES-256 / AES-128 / RC4-128 |
-c |
盖章（stamp）居中 |
-w |
水印（watermark） |
-t |
时间戳水印 |
-l |
左侧水印 |
-i |
内嵌页面 |
-i |
split 时按书签分块 |
-r |
权限：允许打印 |
-w |
权限：允许修改内容 |
-n |
权限：不允许复制内容 |
-p |
权限：允许打印 |
-e |
权限：允许插入/删除页 |
-t |
权限：允许提取页面 |
-c |
权限：允许填表 |
示例
合并两个文件：
1 | pdfcpu merge -o merged.pdf doc1.pdf doc2.pdf |
在第 3 页后插入空白页并输出：
1 | pdfcpu addpage -s 3 input.pdf -o out.pdf |
全部页面旋转 90 度：
1 | pdfcpu rotate -a 90 input.pdf -o out.pdf |
设置禁止复制文本权限：
1 | pdfcpu permissions -n input.pdf -o out.pdf |
局限性须知
- pdfcpu 不做 OCR，无法识别图片中的文字。
- 不支持直接转 Word / Excel；需要先转图片再处理。
- 加密算法依赖所用的 Go 版本及 GC 支持。
更多细节见官方文档：https://github.com/pdfcpu/pdfcpu
本文链接：
https://blog.hisene.com/2026/09/08/pdfcpu文档/