使用Python3+ebooklib生成漫画EPUB无法在Apple Books打开的问题

你生成的EPUB缺少核心结构：iBooks等标准EPUB阅读器要求文件必须包含可被解析的内容章节（HTML页面）、书脊（spine，定义内容阅读顺序）以及导航目录，你的代码只添加了图片资源，但没有将图片嵌入到可展示的页面中，也未构建这些必要结构。另外，os.listdir返回的文件名顺序不确定，可能导致漫画页序混乱。

以下是修复后的完整代码：

from ebooklib import epub
import os

# 初始化EPUB
book = epub.EpubBook()
book.set_title("My Comic Book")
book.set_language('en')
book.set_identifier("com.mycomic.books")  # 添加唯一标识符，适配部分阅读器要求

# 获取排序后的图片文件（确保漫画页序正确）
image_files = sorted([f for f in os.listdir("images") if f.endswith(".jpg")])

chapters = []
for idx, filename in enumerate(image_files):
    # 读取图片内容
    with open(f"images/{filename}", 'rb') as f:
        image_content = f.read()
    
    # 创建图片资源项，统一放在EPUB内部的images目录下
    image = epub.EpubImage()
    image.file_name = f"images/{filename}"
    image.content = image_content
    book.add_item(image)
    
    # 创建对应HTML章节，将图片嵌入页面
    chapter_title = f"Page {idx+1}"
    chapter_html = f'''<html>
<head>
    <title>{chapter_title}</title>
</head>
<body>
    <img src="{image.file_name}" alt="{chapter_title}" style="width:100%;"/>
</body>
</html>'''
    chapter = epub.EpubHtml(title=chapter_title, file_name=f"page_{idx+1}.xhtml", lang='en')
    chapter.content = chapter_html
    book.add_item(chapter)
    
    # 收集章节，用于后续构建导航和书脊
    chapters.append(chapter)

# 添加书脊（spine）：定义阅读器的内容加载顺序，必须包含默认导航页
book.spine = ['nav'] + chapters

# 添加导航目录（toc）
book.toc = tuple(chapters)

# 添加EPUB标准要求的导航文件
book.add_item(epub.EpubNcx())
book.add_item(epub.EpubNav())

# 生成最终EPUB文件
epub.write_epub("my_comic.epub", book, {})

关键修改说明 #

• 添加HTML章节：每张图片对应一个HTML页面，用<img>标签引用图片资源，让阅读器能正常渲染展示图片
• 构建书脊结构：这是EPUB的核心要求，告诉阅读器内容的阅读顺序，必须包含默认导航页nav和所有章节
• 补充导航组件：EpubNcx和EpubNav是EPUB标准强制要求的导航文件，缺失会导致阅读器无法识别格式
• 排序图片文件：用sorted()保证图片按文件名顺序排列，避免漫画页序混乱
• 规范资源路径：将图片统一放在EPUB内部的images目录下，避免根目录文件混乱，同时保证HTML引用路径正确

内容的提问来源于stack exchange，提问作者user791793