企业官网建设流程全解析

PDF补丁丁批量文本替换实操指南：普通、正则、XPath 三种模式怎么选

【免费下载链接】PDFPatcherPDF补丁丁——PDF工具箱，可以编辑书签、剪裁旋转页面、解除限制、提取或合并文档，探查文档结构，提取图片、转成图片等等项目地址: https://gitcode.com/GitHub_Trending/pd/PDFPatcher

PDF补丁丁（PDFPatcher）的批量文本替换功能，能把几百条书签文本几秒内改完：固定词换固定词、带编号的格式重排、按层级精准定位，三种匹配模式各管一摊，改错还能整批撤销，最后直接存成新的 PDF。

同一句课程名，为什么要批量替换

教务处收到 200 份讲义的 PDF，书签里全都写着旧课程名"高数B班"。学期调整之后，每个文件都要打开、逐条点进书签列表、改名、另存——一份文件十分钟，200 份就是十几个小时，还总有几份漏改。

更麻烦的是编号。有的文档把章节编成"课程01 微积分"、"课程02 概率论"，统一格式时要把它改成"1. 微积分"这种样式：编号和文字位置互换了，光靠鼠标一条条敲，改到第 40 条就开始怀疑人生。

这类"规则固定、数量很大"的活，最适合交给批量替换。PDF补丁丁的书签编辑器里内置了这套功能，入口叫搜索及替换书签文本，按下文流程走完一遍，你就能把整摞文档的书签一次改齐。

三种匹配模式怎么选：普通、正则还是 XPath

对话框里"搜索模式"一栏给了三个选项。别背定义，按你手上的活对号入座：

白话解释一下三者差异：普通就是看书签文字里含不含你输入的片段（默认不区分英文大小写、部分匹配就算中）；正则表达式（正则）把搜索内容当成模式，能用括号把某段"圈"出来，替换时再插回去；XPath则把整棵书签树当成一份 XML 文档（白话：一种用标签描述层级的文本格式），你的搜索语句负责"按位置和属性挑出哪些书签"。

完整走一遍：打开讲义，替换课程名

先打开一份真实文档。在主界面左侧功能树里选"编辑书签文件"，点工具栏的打开按钮，指定那份讲义 PDF。程序会把里面的书签读出来，以树形列表展示在中间区域，顶层条目对应各章，展开后是各节。

调出搜索框。点工具栏上的搜索及替换书签文本按钮，或者直接按Ctrl+F，弹出标题为"查找、替换书签项"的对话框。两个输入框右边都有小三角，会带出你上次用过的搜索词和替换词，重复任务省事不少。

先搜后换，这是最重要的习惯。在"搜索文本"框输入高数B班，保持"普通"模式，点搜索全部。底部状态栏会报"找到 N 个匹配的书签"，书签列表同步高亮，你先核对一遍命中范围，确认没扫到不该动的条目，再填替换框。

填好替换文本高数B班（2025版），然后看"替换范围"：只想改当前选中的几条就选选中的书签，全树统一改就选所有书签。点替换，状态栏给出"替换了 N 个匹配的书签"，回到列表看一眼，文字已经更新。

几个参数顺手解释清楚：

• 勾选区分大小写后，B班就不会命中b班；不勾则默认不区分。
• 默认是模糊匹配（书签文字包含搜索片段即算中）；勾上匹配整个书签的文本，必须整条文字完全相同才算中，适合"整句都是这个编号"的场景。
• 正则分组用括号()圈住片段，替换文本里用$1、$2引用。比如搜索课程(\d+) 微积分、替换$1. 微积分，"课程01 微积分"就变成了"1. 微积分"。
• 切到XPath模式后，大小写、整词勾选和替换文本框会整体变灰——XPath 只负责把书签挑出来，改写要换回普通或正则模式再做。书签元素的目标页码、动作等都算它的属性，表达式写法可对照手册里信息文件的"文档书签"一节。

批量替换前的安全自检与常见疑问

正则没匹配到任何书签，怎么排查？先切回普通模式搜一下原文，确认字符串确实存在；再逐段贴你的表达式，定位是哪一段失配。表达式本身写错时程序会直接提示"搜索表达式有误"，照报错改即可。另外别忘了一个细节：.、*这类字符在正则里是特殊符号，想匹配死字符要加反斜杠转义。

批量动手前，如何安全预览影响范围？只点搜索全部、不点替换，看状态栏计数和列表高亮，就是预览。确认无误后，把替换范围切到选中的书签，先在书签列表里手动框住几条目标（按住 Shift 或 Ctrl 多选，Ctrl+A可全选可见项——注意Ctrl+A不会选中未展开的子书签），小范围试跑一次再放量。

替换文本里的$1、$2是什么？是正则分组捕获的内容。搜索表达式里第几对括号，就对应$几。手册里的现成例子：把"子书签 1"、"子书签 2"换成"1)子书签"、"2)子书签"，搜索用子书签([0-9]+)，替换写$1)子书签。

选错模式或改错了怎么办？Ctrl+Z或点撤销，整批替换会作为一个操作被整体回退，不必一条条手工改回去。还有一条定心丸：打开的是 PDF 文件时，保存永远是另存为新文件，原始文档不会被原地改动。

从输入框到书签树：替换是怎么执行的

界面代码在 App/Functions/Editor/SearchBookmarkForm.cs：它收集你的搜索词、模式和替换范围，交给BookmarkMatcher.Create生成一个匹配器——普通模式做字符串包含比较，正则模式按表达式匹配，XPath 模式则把书签树当 XML 文档跑路径查询。匹配命中的节点逐个交给 ReplaceTitleTextProcessor 改写文本，整批改动被打包进一个撤销组，所以一次Ctrl+Z就能全部回滚。更多同类处理器集中在 App/Processor/InfoXmlProcessors/ 目录。

相关资源

• 使用手册对应章节：doc/使用手册.md 的"搜索及替换书签文本"一节，含正则与 XPath 示例表。
• 核心处理代码：App/Processor/InfoXmlProcessors/；界面实现见上文链接。
• 需要源码时执行git clone https://gitcode.com/GitHub_Trending/pd/PDFPatcher。

先拿一份书签较多的文档练手：普通模式换一遍课程名，正则重排一遍编号，XPath 只挑一层书签做一次定位——三样都跑通，批量替换就再也不会翻车。

【免费下载链接】PDFPatcherPDF补丁丁——PDF工具箱，可以编辑书签、剪裁旋转页面、解除限制、提取或合并文档，探查文档结构，提取图片、转成图片等等项目地址: https://gitcode.com/GitHub_Trending/pd/PDFPatcher