C#生成EPUB电子书文件 C#如何将文本和图片打包成EPUB格式

EPUB本质是按特定结构组织的ZIP包，含container.xml、content.opf、HTML等文件；可用SharpZipLib手动构建或EpubLib快速生成（仅支持EPUB 2）；需严格遵循路径、命名空间、编码及MIME类型规范，否则阅读器无法打开。

EPUB本质是ZIP压缩包，不是专用二进制格式

EPUB文件其实就是一个按特定目录结构组织的ZIP包，里面包含META-INF/container.xml、content.opf、toc.ncx（或nav.xhtml）、HTML内容页、CSS、图片等。C#不需要“EPUB专用库”也能生成，但手动拼装容易出错——比如container.xml路径写错、MIME类型漏声明、OPF中manifest与spine不一致，都会导致阅读器打不开。

推荐用 SharpZipLib（处理ZIP） + 手动构造XML文件，或更稳妥地用 EpubLib（NuGet包：Idelta.EpubLib），它封装了OPF/NCX生成逻辑，但注意它不支持EPUB 3的nav.xhtml，只生成EPUB 2。

• EpubLib对中文路径支持弱，图片文件名含中文时需先Uri.EscapeDataString()编码再加入包内
• 所有HTML内容页必须用.xhtml扩展名，且根元素为
• CSS建议内联（避免外部引用失败），或确保CSS路径在OPF的manifest中声明为application/css

用EpubLib快速生成带图文本：关键三步

以一段含标签的Markdown转HTML后打包为例：

var book = new EpubBook();
book.Title = "我的笔记";
book.Author = "作者";

// 添加封面图（可选，但多数阅读器要求）
var coverPath = "cover.jpg";
book.AddCoverImage(coverPath, File.ReadAllBytes(coverPath));

// 添加正文HTML（必须是UTF-8字节流，且含完整xhtml结构）
string htmlContent = @"
  
  
    
这是文字
    @@##@@
  
";
book.AddHtml("chapter1.xhtml", Encoding.UTF8.GetBytes(htmlContent));

// 添加图片（路径需与HTML中src一致，且加到images/子目录下）
book.AddImage("images/photo.png", File.ReadAllBytes("photo.png"));

// 生成
book.Save("output.epub");

注意：AddImage()第二个参数是byte[]，不是文件路径；AddHtml()传入的是已编码的字节，不是字符串；如果HTML里用了相对路径如images/photo.png，就必须用完全相同的路径字符串调用AddImage()，大小写和斜杠方向都不能错。

标贝科技

标贝科技-专业AI语音服务的人工智能开放平台

下载

手动ZIP方式：绕过库限制但需严守规范

当需要EPUB 3支持（如nav.xhtml、视频、MathML）或定制OPF元数据时，直接用ZipFile（SharpZipLib）更可控：

• 先创建临时文件夹，按EPUB结构放好所有文件（META-INF/、OEBPS/等）
• container.xml必须放在META-INF/container.xml，内容指向OEBPS/content.opf
• content.opf中每个资源都要有，图片的media-type必须是image/jpeg或image/png，不能写image/jpg
• 生成nav.xhtml时，必须有epub:type="toc"属性，且
  嵌套层级要合法

常见报错：Calibre报错“no spine item found” → 检查content.opf中下的是否对应中已声明的id；微信读书打不开 → 多半是HTML未声明xhtml命名空间或字符编码不是UTF-8无BOM。

图片处理的隐性坑：尺寸、格式、嵌入路径

EPUB阅读器对图片兼容性差异大：Kindle仅支持JPEG/PNG，不认WebP；Apple Books对SVG支持有限；Kobo要求图片宽度不超过1024px否则缩放异常。

• 图片文件名避免空格和中文，用photo_01.png比我的配图.jpg更安全
• HTML中和AddImage("photo.png", ...)的路径必须字面量一致（区分大小写）
• 若图片来自内存流（如Bitmap.Save(ms, ImageFormat.Png)），记得ms.Position = 0再读取字节，否则写入ZIP为空
• 批量添加时别用Directory.GetFiles()直接遍历——EPUB要求路径分隔符统一为/，Windows返回\会导致路径解析失败

最易被忽略的一点：EPUB标准要求所有资源路径在OPF中声明的href值，必须与ZIP内实际路径**完全一致**，包括大小写、前后斜杠、是否带./前缀——这里错一个字符，整个文件就可能被判定为损坏。