cpdf是一款跨平台的命令行PDF处理工具，支持PDF的合并、拆分、加密、书签编辑等多种操作，其中按子书签拆分PDF是非常实用的功能，适合处理包含多个章节、子章节的长文档。
cpdf工具安装方法
不同系统的安装方式略有区别，以下是常见系统的安装步骤：
- Windows系统：从cpdf官方发布页下载对应版本的二进制文件，解压后将可执行文件路径添加到系统环境变量即可使用。
- macOS系统：可以通过Homebrew包管理器执行
brew install cpdf命令直接安装。 - Linux系统：多数发行版的官方源包含cpdf包，执行
sudo apt install cpdf（Debian/Ubuntu）或sudo yum install cpdf（CentOS/RHEL）即可完成安装。
按子书签拆分PDF的核心命令
cpdf按子书签拆分PDF的核心命令格式如下：
# 基础拆分命令，将输入PDF按子书签拆分成多个文件 cpdf -split-by-bookmark 1 input.pdf -o output_%02d.pdf
命令参数说明：
-split-by-bookmark 1：指定按一级子书签拆分，数字1表示子书签的层级，若需要按二级子书签拆分可改为2，以此类推。input.pdf：需要拆分的原始PDF文件路径。-o output_%02d.pdf：输出文件的命名规则，%02d表示两位数字序号，拆分后的文件会依次命名为output_01.pdf、output_02.pdf等。
完整操作示例
假设我们有一个名为技术文档合集.pdf的文件，包含3个一级子书签，分别是第一章、第二章、第三章，现在需要按这三个子书签拆分成独立文件：
# 查看PDF的书签结构，确认子书签层级 cpdf -list-bookmarks 技术文档合集.pdf # 按一级子书签拆分文件 cpdf -split-by-bookmark 1 技术文档合集.pdf -o 拆分结果_%02d.pdf
执行上述命令后，当前目录会生成三个PDF文件，分别对应原文档的三个子书签内容，每个文件仅包含对应子书签下的所有页面。
常见问题与解决方案
拆分后文件命名不符合预期
如果需要自定义输出文件的命名，可以结合书签名称生成文件名，示例命令如下：
# 按子书签拆分并使用书签名称命名文件 cpdf -split-by-bookmark 1 技术文档合集.pdf -o "%%s.pdf"
这里的%%s会替换为对应子书签的名称，生成的文件会以书签名作为文件名。
子书签层级识别错误
如果拆分结果不符合预期，先通过cpdf -list-bookmarks 文件名.pdf命令查看书签的层级结构，确认需要拆分的子书签对应的层级数字，再调整-split-by-bookmark后的参数即可。
拆分后页面内容缺失
这种情况通常是子书签对应的页面范围设置问题，cpdf默认会提取子书签对应的所有连续页面，若子书签存在跨页不连续的情况，需要手动指定页面范围后再拆分，示例：
# 提取指定页面范围后按子书签拆分 cpdf 技术文档合集.pdf 1-50 -split-by-bookmark 1 -o 部分拆分_%02d.pdf
上述命令会先提取原PDF的1到50页，再对这部分内容按一级子书签拆分。