本文介绍使用 ExtendScript（JavaScript）调用 InDesign API 的 findText() 方法，批量检索文档中关键词出现的所有页码，并自动去重、排序后返回结果。适用于多页出版物的关键词索引、内容审计与自动化排版校验场景。
本文介绍使用 extendscript（javascript）调用 indesign api 的 `findtext()` 方法，批量检索文档中关键词出现的所有页码，并自动去重、排序后返回结果。适用于多页出版物的关键词索引、内容审计与自动化排版校验场景。
在 Adobe InDesign 中，当需要为关键词或关键短语生成页码索引（如术语表、法规引用清单或内容溯源报告）时，手动翻页查找效率极低且易出错。借助 ExtendScript 脚本，可全自动完成“关键词 → 页码列表”的映射任务。核心思路是：清空查找偏好设置，设定目标文本，执行全局文本搜索，再从每个匹配结果的父级对象向上追溯至所属页面（parentPage.name），最终聚合、去重并升序排列页码。
以下为完整可运行脚本（兼容 InDesign CC 2019 及以上版本）：
// 清除查找偏好，避免受历史设置干扰 app.findTextPreferences = NothingEnum.NOTHING; // 从当前选中文本获取待查关键词（支持中英文、标点、空格） if (app.selection.length === 0 || !(app.selection[0] instanceof Text)) { alert("请先选中一段文本作为关键词！"); exit(); } app.findTextPreferences.findWhat = app.selection[0].contents; // 执行全文档范围查找（含所有主文本框架、附注、标题等） var foundItems = app.activeDocument.findText(); // 提取唯一页码并转为数字数组 var pageSet = {}; var pageNumbers = []; for (var i = 0; i < foundItems.length; i++) { var textItem = foundItems[i]; // 安全获取所属页面：确保匹配项位于有效文本框架内 if (textItem.parentTextFrames && textItem.parentTextFrames.length > 0) { var page = textItem.parentTextFrames[0].parentPage; if (page && page.name) { var pageNum = +page.name; // 强制转换为数字（兼容罗马数字页码需额外处理） if (!pageSet[pageNum]) { pageSet[pageNum] = true; pageNumbers.push(pageNum); } } } } // 升序排序（对阿拉伯数字页码有效；若含罗马数字，建议改用自定义排序逻辑） pageNumbers.sort(function(a, b) { return a - b; }); // 输出结果（支持复制粘贴到 Excel 或报告中） alert("关键词 "" + app.findTextPreferences.findWhat + "" 出现在以下页码：n" + pageNumbers.join(", "));✅ 关键注意事项：
- 脚本默认以当前选中文本为关键词，支持跨段落、跨文本框匹配，但不匹配隐藏图层或锁定图层中的内容（需提前解锁/显示）；
- parentPage.name 返回的是 InDesign 页面面板中显示的页码（可能为罗马数字或自定义前缀），若需纯数字页码，请确保文档使用标准阿拉伯数字编号，或在脚本中添加正则清洗逻辑（如 page.name.replace(/[^0-9]/g, ”)）；
- 多列文本、嵌套表格、脚注内的文本均可被正确捕获，但超链接文本、xml 标签内容、图形替代文本不在 findText() 默认范围内，需另行扩展；
- 若需批量处理多个关键词，可将上述逻辑封装为函数，并配合 for…of 循环或 CSV 导入实现批量化索引生成。
该方案显著优于人工核查，单次运行即可完成数十页文档的关键词页码定位，是出版流程自动化与内容质量管控的重要技术支点。