使用Python的ebooklib生成EPUB时添加样式表无效的问题排查

核心问题：样式表未正确关联到章节，或资源/优先级问题导致样式失效 #

• 样式表未与章节HTML绑定
  仅把CSS添加到book对象里是不够的，必须让每个章节的HTML文件主动引用这个样式表。给每个章节对象关联样式表：

  # 创建章节
  chapter = epub.EpubHtml(title='第一章', file_name='chap_01.xhtml', lang='zh')
  chapter.content = '<h1>第一章内容</h1><p>测试文本</p>'
  
  # 把样式表关联到章节
  chapter.add_item(nav_css)
  # 或者手动添加<link>标签到章节头部
  chapter.add_link(href='style/nav.css', rel='stylesheet', type='text/css')
  
  book.add_item(chapter)
  

• 背景图未加入EPUB包
  你只在CSS里写了图片路径，但没把图片文件作为资源加入EPUB，阅读器根本找不到这张图。先把图片添加到书籍中：

  # 读取本地图片文件
  with open('watermark.png', 'rb') as f:
      img_data = f.read()
  
  # 创建图片资源项并加入书籍
  watermark = epub.EpubItem(uid='watermark_img', file_name='watermark.png', media_type='image/png', content=img_data)
  book.add_item(watermark)
  

  此时CSS里的../watermark.png路径是正确的（CSS在style/目录，图片在EPUB根目录）。

• 样式被阅读器默认样式覆盖
  多数EPUB阅读器自带默认样式，优先级高于自定义样式。可以用!important强制生效：

  style = 'body { color: red !important; background-image: url(../watermark.png) !important; background-repeat: no-repeat; background-attachment: fixed; }'
  

• 章节HTML结构不匹配选择器
  如果章节内容被包裹在特定容器（比如<div class="content">）里，直接设置body样式可能无效，需要针对实际容器写选择器：

  style = '.content { color: red; background-image: url(../watermark.png); }'
  

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