pdfcpu 0.16.4:8.9k star 的 Go 单文件 PDF 工具

Go 写的单文件 PDF 处理器,批处理友好

更新时间:2026-11-22 21:23:47

访问次数:4

详细介绍
一句话结论:pdfcpu 是 Go 写的 PDF 库加命令行工具,Apache-2.0、GitHub 8.9k star、当前 0.16.4,编译出来就是一个静态二进制,不依赖 Python、Java 或外部服务。校验、优化、合并拆分、加印章水印、加解密、管附件都能做,PDF 2.0 支持是基础级别。

这是什么

pdfcpu 把 PDF 处理做成一个单文件 CLI:下载对应平台的二进制,chmod +x 就能跑。它既能当命令行工具,也能作为 Go 库嵌进后端服务,官方列出的能力包括校验、优化、拆分、裁剪、合并、提取图片和字体、改元数据、加解密、旋转缩放、印章水印、签名完整性检查、附件管理。

它和 QPDF 的定位有重叠,但路线不同:QPDF 更偏底层对象与结构,pdfcpu 更偏「一条命令完成一个业务动作」,而且单二进制部署对容器和边缘机器很友好。

我怎么用它

  • 先跑 pdfcpu validate,确认文件结构没坏,再进后续流程;
  • 用 optimize 压一遍对象流,扫描件体积能降一点,但别指望它替代图片压缩;
  • 合并按文件名排序,脚本里先 sort 再传,不然顺序会乱;
  • 给每页加页码或水印用 stamp,把字体和位置写成配置,批量复用;
  • 打包进 Docker 时只拷二进制,镜像能做得很小,启动也快。

上手截图

pdfcpu 0.16.4:8.9k star 的 Go 单文件 PDF 工具

图:pdfcpu 的 Go 包文档页,v0.16.4、Apache-2.0,命令列表从 annotations 到 encrypt 一目了然

优点

  • 单二进制、零运行时依赖,Windows、Linux、macOS 都能直接跑;
  • 命令覆盖的业务面广,合并、拆分、印章、加密不用拼多个工具;
  • Apache-2.0,Go 库还能直接嵌进自己的服务;
  • 批处理和容器场景友好,镜像体积和启动时间都好控制。

缺点

  • 只有命令行,没有图形界面,非技术同事用不了;
  • PDF 2.0 校验只是基础支持,复杂新规范文件仍可能报错;
  • 不做 OCR、不渲染页面、不抽正文,别把它当全能编辑器;
  • 印章和水印要配字体,字体路径不对会直接失败。

什么时候别用它

要拖拽页面、改文字、OCR,选 PDF Arranger、PDFgear 或 Stirling。只做底层结构修复和线性化,QPDF 更专;要一个命令搞定业务动作,pdfcpu 更顺。

网友评论