EPUB有正文目录却不能跳章：区分页面目录与导航目录

开始前先确认

这种现象的核心原因在于：正文中的“页面目录”与阅读器依赖的“系统导航目录”，是两个需要分别验证的用途；EPUB 3 的同一导航 XHTML 也可以加入阅读顺序，兼作可见目录页。前者只是读者在版面上看到的普通 HTML 文本与超链接，而后者是由独立结构化文件驱动的阅读器系统指令。因此，看到可点击的目录页，仍不足以确认阅读器能识别导航结构。

核心机制：页面目录（Inline TOC）与导航目录（Nav TOC）

要彻底排查该问题，首先需要理解电子书阅读器解析目录的底层逻辑。

+-------------------------------------------------------------+
|                     EPUB 电子书容器                          |
|                                                             |
|  [ 正文页面目录 Inline TOC ]       [ 系统导航目录 Nav TOC ]     |
|  - 表现：排版在正文内的章节列表   - 表现：阅读器侧边栏/系统菜单 |
|  - 载体：普通 XHTML 页面          - 载体：专用导航文档 / NCX    |
|  - 机制：HTML 内部锚点超链接      - 机制：语义化层级数据结构    |
|  - 作用：仅供当前页面翻阅点击     - 作用：全局跨章节快速定位    |
+-------------------------------------------------------------+

1. 页面目录（Inline TOC）

页面目录是排版人员直接写在正文内容文档中的章节清单。它可以是一个 XHTML 文件（例如 toc.xhtml 或正文开篇页面），使用普通的 HTML 列表标签（如 <ul>、<li>）配合 <a href="chapter1.xhtml"> 锚点链接组成。

• 特点：只有翻页阅读到该页时才能看到；其跳转行为与普通网页超链接一致。
• 局限：主流电子书阅读软件不会主动扫描正文内的超链接来拼凑系统目录树。如果只有页面目录，阅读器的侧边栏目录面板就无法获取数据。

2. 系统导航目录（Nav TOC）

系统导航目录是专门提供给阅读软件解析的全局结构化数据。

• 根据 W3C EPUB 3.3 规范，EPUB 3 要求在导航文档中包含带有 epub:type="toc" 属性的 <nav> 元素，专门用于向阅读系统声明书籍的层级结构。这一导航文档独立于正文展示逻辑，阅读器正是通过它在界面侧边栏生成可随时展开、折叠并跳章的目录树。
• 需要注意的是，不要将 EPUB 3 的规则套用到所有旧格式上。在较早的 EPUB 2 规范中，系统导航依赖的是独立的 toc.ncx（XML 格式）文件。两者的语法与声明方式不同，但目的都是服务于阅读器的系统级交互。

若制作工具仅生成了正文 HTML 超链接，而未生成或未正确注册规范的导航文档，就会出现“正文可见目录，但阅读器侧边栏空空如也”的现象。

交付前排查排错的具体步骤

在将 EPUB 文件正式交付给客户或分发前，建议按照以下步骤进行标准化检查：

步骤一：双阅读器交叉比对合法原文件

不要仅依赖单一阅读软件进行验收。不同阅读软件（如 Apple Books、Kobo、微信读书或各类多平台桌面阅读器）对于缺少部分规范标签的容错机制各不相同。

• 取未修改的合法原始文件，在至少两款独立的标准阅读软件中打开测试。
• 分别测试：① 翻至正文目录页点击文字是否跳转；② 呼出阅读器顶栏或底栏菜单，查看系统目录面板是否正常加载章节层级。
• 合规与版权边界：所有排查工作必须基于拥有合法编辑权限的原稿或无版权保护的文件。对于受数字版权管理（DRM）加密的书籍，禁止尝试绕过或破坏版权保护机制。

步骤二：检查文件内是否存在专用导航声明

使用解压工具（EPUB 本质上为 ZIP 压缩包）或专业电子书编辑软件解开包体，检查内部文件结构：

1. 先从 `META-INF/container.xml` 的 `rootfile` 定位包文档（文件名不一定是 `content.opf`）：查看 <manifest> 节点中是否正确注册了导航文件。

* EPUB 3 标准：应包含类似 <item id="nav" href="nav.xhtml" media-type="application/xhtml+xml" properties="nav"/> 的声明。 * EPUB 2 标准：应包含类似 <item id="ncx" href="toc.ncx" media-type="application/x-dtbncx+xml"/>，且 <spine toc="ncx"> 属性已正确绑定。

1. 核验文件内容：打开对应的导航文件，确认内部各章节的引用路径是否真实存在。

步骤三：验证目标文件名与锚点路径大小写

包内链接的路径和锚点应精确匹配，不能依赖某台电脑对大小写的宽容行为：

• 检查导航文件中的链接目标（如 Chapter01.xhtml#section1）与实际正文文件名、内部 id 属性是否完全一致。
• 若正文文件名修改为小写但导航文件中仍为大写，会导致侧边栏点击后无响应或报错跳出。

判定对照表与交付检查清单

目录机制判定对照表

交付前核验清单（Checklist）

• [ ] 原稿完整备份：在调整任何配置前，已将初始工程与文件另存备份。
• [ ] 阅读器双端验证：已在两款不同内核的标准阅读软件中测试侧边栏目录呼出功能。
• [ ] 导航属性完整：EPUB 3 的导航 XHTML 文件已在 OPF 中添加 properties="nav"，或 EPUB 2 正确绑定了 toc.ncx。
• [ ] 锚点路径校对：系统导航条目链接的目标文档与锚点 ID 均能精确定位，无大小写错位。
• [ ] 范围边界清晰：本次检查仅针对章节导航跳转，若遇到版面内排版错落，可参阅关于 EPUB图片缺失排查 以及 EPUB动态页码与翻页机制 的专门说明。

场景示例：一份交付文件的排查过程（假设案例）

以下为一个典型的排错与修复推演，用于说明两者的边界关系：

• 背景设定（假设）：排版人员通过写作软件将一份《企业操作规程》导出为 EPUB 交付给测试团队。
• 发现问题：测试人员在电脑端阅读软件打开时，翻到第 2 页能够看到完整的目录文字，点击“第一章”也能跳转到正文；但将文件发送到墨水屏阅读器后，点击系统底栏的“目录”图标，屏幕提示“本书无目录”。
• 排查定位：

1. 打开导出工程的源文件设置，发现排版人员仅在正文最前方插入了“文档内目录（TOC Bookmark）”，该功能仅在 Markdown 导出 HTML 时批量生成了内部锚点链接。 2. 检查生成的 EPUB 包体结构，发现 content.opf 的 manifest 清单中并没有任何带有 properties="nav" 属性的文件，阅读系统自然无法捕捉到全局导航。

• 解决验证：排版人员回到制作软件的导出配置中，使用该工具提供的导航生成或修复功能（菜单名称随工具而异），重新构建后，EPUB 包内正确生成了包含 <nav epub:type="toc"> 的导航文档。再次测试时，侧边栏目录树恢复正常层级展示。若原始稿件基于标记语言编排，也可参考 Markdown导出规范 检查标题层级结构。

常见认知误区与平台能力边界

在日常处理与交付电子书时，需要注意以下常见误区与工具局限：

1. 误区：能点击正文蓝字就等于做好了电子书目录

普通链接清单若未满足导航语义和包声明，就不能替代系统目录；符合要求的 EPUB 3 导航文档可以同时在正文显示。交付标准必须以侧边栏能否呼出分级目录为准。

1. 误区：EPUB 3 与 EPUB 2 目录文件可以任意互换

直接将 EPUB 2 的 toc.ncx 强行塞入未作适配的 EPUB 3 流程，部分严格遵循规范的新一代阅读器会直接忽略，导致导航缺失。必须根据书籍的目标版本选择对应的标准。

1. 回到制作工具修复：AI Lab 的 EPUB 阅读功能可用于预览，不能据此认定它会重建导航。完成修复后还应运行 EPUBCheck，并在目标阅读器实测。

下一步行动建议

当确认手头的 EPUB 存在“仅有页面目录、缺少导航目录”的现象时：

1. 先保留原稿：切勿直接在成品文件上强行改动压缩包内容，避免导致压缩打包方式错误使得 EPUB 无法解包。
2. 追溯源头工具：返回原排版软件（如 Sigil、Calibre 转换器、Indesign 或 Markdown 导出引擎），检查导出设置中的“生成目录 / NCX / Navigation”选项是否勾选完整。
3. 完成双端核验：重新导出后，使用两款不同阅读器完成“侧边栏跳章”与“正文跳章”的双重验证，确认无误后再进行最终交付。