epub本质是遵循ocf标准的zip归档，须用zip库解压后解析meta-inf/container.xml获取content.opf路径，再提取并用tinyxml2/pugixml解析xml；需注意命名空间、路径分隔符、utf-8编码及非标epub容错。
EPUB本质是ZIP压缩包，先解压再读OPF
EPUB文件不是普通二进制文档，而是遵循Open Container Format（OCF）的ZIP归档。它的content.opf（实际路径通常是META-INF/container.xml里声明的full-path值）一定藏在ZIP内部，不能直接用fopen或std::ifstream打开。硬读会失败，报No such file or directory或乱码。
实操建议：
- 用轻量ZIP库（如
miniz或zip.hpp）解压到内存或临时目录——不推荐全解压到磁盘，太慢且污染文件系统 - 先读取
META-INF/container.xml，解析出rootfile的full-path属性（常见为OEBPS/content.opf或content.opf） - 再从ZIP中提取该路径对应的条目内容，转成
std::string或std::vector<char></char>
用tinyxml2或pugixml解析OPF XML更可靠
content.opf 是标准XML，但结构嵌套深、命名空间多（如 opf:, dc:），手写正则或简易字符串查找极易漏字段或崩在特殊字符上。C++标准库没有内置XML解析器，别试图用std::regex硬刚。
实操建议：
- 选
tinyxml2：头文件即用，无依赖，适合嵌入式或轻量工具；注意调用doc.Parse()后检查返回值，XML_SUCCESS才安全 - 选
pugixml：性能更好，支持XPath子集；用pugi::xml_parse_result判断是否含BOM或编码错误（OPF常为UTF-8 with BOM） - 必须处理命名空间：tinyxml2默认忽略前缀，直接用
"metadata"、"dc:identifier"会找不到节点；pugixml需用document.select_node("//opf:metadata")并注册命名空间
OPF里关键信息不在根节点，得按规范路径查
很多人以为读到<package></package>就完事了，其实核心元数据（标题、作者、UUID）都在<metadata></metadata>下，而章节清单（spine）和资源映射（manifest）是平级兄弟节点。直接遍历FirstChildElement()容易跳过metadata。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
实操建议：
- 查标题：
doc.FirstChildElement("package")->FirstChildElement("metadata")->FirstChildElement("dc:title")->GetText() - 查作者：
FirstChildElement("dc:creator")可能有多个，需循环；注意有些EPUB用opf:meta补充作者角色（如role="aut"） - 查主文档路径（spine第一个itemref指向的id）：先取
spine的toc属性值，再在manifest中找对应id的href—— 这个href才是HTML正文路径
Windows下路径分隔符和编码容易出问题
EPUB规范强制用正斜杠/作路径分隔符，但Windows本地解压工具（如系统自带ZIP）可能生成反斜杠，导致miniz查不到OEBPS/content.opf；另外，OPF文件本身是UTF-8，但Windows控制台默认ANSI，std::cout 可能显示为方块。
实操建议：
- ZIP解压时统一用
miniz::mz_zip_reader_extract_file_to_heap提取原始字节，避免路径转换；用std::string_view比对路径时，把输入路径里的\全替换成/ - 输出中文标题前，用
SetConsoleOutputCP(CP_UTF8)（Windows）或确保终端支持UTF-8；Linux/macOS一般没问题 - 不要依赖
std::filesystem::path的operator/拼接OPF内路径——它在Windows下会插，破坏ZIP路径匹配逻辑
真正麻烦的不是读OPF，而是处理不同出版商生成的非标EPUB：有的缺dc:identifier，有的spine里linear="no"的隐藏导航页，有的OPF里href带../相对路径。这些得靠具体case加容错，不是通用解析器能覆盖的。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
