EPUB 错误参考

把 EPUB 错误代码变成文件、原因和修复步骤。

不要只改错误文案,要先识别容器、OPF 元数据、导航、XHTML、CSS、媒体或无障碍所在层,再验证替换文件。

按文件包层诊断先做本地结构预检链接官方验证器
默认保护隐私

放入你准备出版的文件

请选择 DOCX 或 EPUB。首次检查在浏览器内完成,书稿不会上传。

先看位置,再看错误描述

验证结果通常包含严重程度、代码、文件路径、行号和解释。路径会告诉你问题在 package.opf、nav.xhtml、章节、CSS 还是媒体资源。尽量修复生成源,而不是手改下次会被覆盖的导出文件。

常见错误家族
层级典型问题修复方向
容器包路径缺失或错误修复 META-INF/container.xml
OPF 元数据缺书名、语言或标识符补全出版元数据
Manifest/spine缺项目或阅读顺序错误重建引用和顺序
XHTML嵌套无效或 ID 重复修复语义标记
导航目标损坏或缺 nav重建目录链接
媒体文件缺失或类型错误添加资源并修正类型

最终标准检查使用官方 EPUBCheck

ShipMyBook 浏览器工具是有边界的结构预检;EPUBCheck 是开放且完整的标准参考。每次修复后运行当前版本,并在真实阅读器中校样;零错误也不代表视觉与无障碍体验一定优秀。

FAQ

常见问题

所有 warning 都会阻断发布吗?

不会。需要结合严重程度与平台要求,理解并记录决定,而不是一律忽略。

为什么验证通过仍显示错误?

验证检查标准结构,CSS、图片、字体回退、设备差异和无障碍仍需实际校样。

定位层级后,修复并重新验证。

付费发布会把修复 EPUB 与源书稿、印刷文件、封面和元数据绑定。

查看修复价格