本文介绍使用 ExtendScript（JavaScript）自动化获取多页 InDesign 文档中指定关键词出现的所有页码，通过 findText() 方法高效提取、去重并排序页码，适用于批量文档分析与内容索引生成。
本文介绍使用 extendscript（javascript）自动化获取多页 indesign 文档中指定关键词出现的所有页码，通过 `findtext()` 方法高效提取、去重并排序页码，适用于批量文档分析与内容索引生成。
在 Adobe InDesign 的自动化工作流中，快速定位关键词在长文档中的物理页码（如 PDF 导出前的校验、术语索引生成或合规性审查），是专业排版与出版流程中的高频需求。手动翻页查找不仅低效，还极易遗漏。借助 ExtendScript，我们可调用原生 API 实现毫秒级全文扫描与页码映射。
核心思路是：清空查找偏好 → 设置目标文本 → 调用 findText() 获取全部匹配对象 → 遍历结果，从每个匹配项的父容器（parentTextFrames[0]）向上追溯至所属页面（parentPage.name）→ 去重并数值排序。
以下为完整、健壮的脚本示例（已优化容错性与可读性）：
// 清除现有查找偏好，避免干扰
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();
if (foundItems.length === 0) {
alert("未找到匹配内容。");
exit();
}
// 提取唯一页码（支持罗马数字页码如 "ii"、"III" 和阿拉伯数字混合）
var pageNumbers = {};
var uniquePages = [];
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;
// 若需统一转为数字用于排序（仅当页码全为阿拉伯数字时启用）
// var numValue = parseInt(pageNum, 10);
// if (!isNaN(numValue) && !(pageNum in pageNumbers)) {
// pageNumbers[pageNum] = true;
// uniquePages.push(numValue);
// }
// 否则保留原始页码字符串（推荐：兼容任意页码格式）
if (!(pageNum in pageNumbers)) {
pageNumbers[pageNum] = true;
uniquePages.push(pageNum);
}
}
}
}
// 按 InDesign 页面顺序排序（非字典序！需按实际页面索引排序）
uniquePages.sort(function(a, b) {
var idxA = app.activeDocument.pages.item(a).index;
var idxB = app.activeDocument.pages.item(b).index;
return idxA - idxB;
});
alert("关键词出现在以下页码：" + uniquePages.join(", "));✅ 关键注意事项：
- 该脚本依赖 parentTextFrames[0] 获取匹配文本所在的文本框，若文本跨多个文本框（如串接文本框），需额外遍历 textItem.parentTextFrames 数组；
- page.name 返回的是用户界面中显示的页码（支持章节编号、前缀、罗马数字等），而非 page.index（内部索引），因此更符合出版场景需求；
- 若需导出结构化结果（如 CSV 或 JSON），可将 uniquePages 替换为对象数组：{pageName: "5", occurrences: 3}；
- 大型文档建议添加进度提示（app.scriptPreferences.enableRedraw = false + progressBar），防止 UI 卡顿。
掌握此方法后，你可轻松扩展功能：例如批量处理多个关键词、高亮对应页面、或生成自动索引表——真正将 InDesign 从设计工具升级为智能内容分析平台。
