上周六在家整理代码仓库的文档，准备把分散在几个文件夹里的接口说明、数据库设计、部署手册合并成一份完整的PDF，方便周一给新同事做入职参考。总共二十来个文件，我想都没想就打开了终端。

Ghostscript是第一个想到的工具。装了这么多年，命令行参数我甚至能背下来：

gs -dBATCH -dNOPAUSE -q -sDEVICE=pdfwrite -sOutputFile=merged.pdf *.pdf

回车之后报错了。提示某几个PDF有加密保护，Ghostscript直接拒绝处理。加密的文件是之前从公司系统导出的，密码我早忘了。折腾了半天，写了个循环脚本跳过加密文件，总算跑通了。结果打开输出的PDF一看，里面有两张横向的架构图被自动旋转成了竖版，比例完全不对。

参数。加上之后重新跑，架构图方向对了，但A3尺寸的部署拓扑图又被裁掉了一截。继续翻StackOverflow，有人提到还要加

来来回回改了五六次参数，花了一个多小时，最后生成的PDF里文字字体全部变成了莫名其妙的衬线体，间距稀碎，跟原文件完全不一样。可能是字体嵌入的问题，也可能是我某个参数搞错了。总之结果没法用。

这时候我已经有点烦躁了。就想合并几个PDF而已，又不是什么高并发场景，也不是生产环境排障，至于费这么大劲吗。

Pdfunite也试了。命令确实简单，

，两秒钟就完了。但加密文件直接让它崩溃退出，毫无商量余地。混合页面尺寸的文件合完之后排版整个乱掉，A4页面和A3页面互相打架。

搞了快两个小时，我把终端关了。

后来是在手机里找到解决办法的。当时想起来之前同事提过一嘴，说小程序里有个什么工具能直接合PDF。我用手机打开搜了一下，随便点开一个，把20个文件传上去，拖了拖顺序，点了合并。大概等了十来秒，生成的文件下载下来，翻了几页，加密文件的页面正常显示了，架构图没被旋转，A3页面也完整保留。最让我意外的是，合并后的文件体积和源文件总和几乎一样，说明它没有重新压缩编码，只是做了页面流的拼接。

后来又试了另一个小程序，速度更快，三秒左右就完事了。不过这个输出的文件体积比源文件总和略小一点，扫描件部分被轻度压缩过，画质有轻微下降，但不对比原文件基本看不出来。

两个都试完之后我坐下来想了想，觉得这件事挺有意思的。同样是PDF合并，命令行方案灵活但挑文件，小程序方案封闭但省心。不是谁替代谁的问题，是场景不同。

如果这个合并操作要嵌入到自动化流程里

，比如CI/CD管线中的文档打包，那Ghostscript还是唯一解。哪怕调参麻烦，但一旦写好了脚本，以后就是一键的事。

如果只是临时合并几个文件发给同事

，用pdfunite一行命令也够了，前提是文件没有加密、尺寸统一。

，或者你人在外面手边只有手机，那小程序这种方案确实能省掉很多麻烦。它最大的局限是没有API，没办法集成到自动化流程里，但对于单次的人工操作来说，这个局限其实无所谓。

那天下午折腾完后我把经验整理了一下，写了个内部Wiki记录，大意是：

写完发到团队群里，后端老张回了一句：“你终于悟了，我上次合并需求文档也是用手机搞定的。”

技术工具的选择，说到底是为效率服务的。适合场景的才是好用的，不用非要分个高下。

(周末在家折腾的碎碎念，没有任何方法论参考价值。)

记一次PDF合并的踩坑经历：从命令行翻车到意外解决的周末下午

开发工具

职业发展

后端

PDF合并工具选择需根据场景决定：命令行方案适合自动化流程但参数复杂，小程序方案操作简单但无法集成。技术选型关键在于判断是否需要重复使用或自动化处理，灵活选择最适合当前需求的工具才能提高效率。

数据库

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

记一次PDF合并的踩坑经历：从命令行翻车到意外解决的周末下午

记一次PDF合并的踩坑经历：从命令行翻车到意外解决的周末下午

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐