本文介绍使用 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 导入实现批量化索引生成。
该方案显著优于人工核查，单次运行即可完成数十页文档的关键词页码定位，是出版流程自动化与内容质量管控的重要技术支点。
