IDML 文件本质是 ZIP 压缩包，需解压后查看 XML 结构；核心文件包括 Stories/（文本内容）、Spreads/（布局）、Resources/（资源）、Document.xml（全局设置）和 DesignMap.xml（结构索引），命名空间 idP:/idQ: 不可省略，跨文件引用需统一管理。
如何正确查看 IDML 的 XML 结构
先解压，再读 XML：
– 用 7-Zip、WinRAR 或系统自带归档工具（macOS 双击、Linux unzip）解压 IDML 文件；
– 解压后你会看到标准目录结构，核心文件集中在：
-
Stories/：每个.xml文件对应一个「故事（story）」，即一段可编辑的文本流（含样式、段落、字符级标记）； -
Spreads/：页面布局信息，如spread_1.xml描述左右两页的框架、图文框位置、图层顺序； -
Resources/：字体（FontFamilies/）、颜色（Swatches/）、图形（Graphics/）、样式（ParagraphStyles/,CharacterStyles/）等资源定义； -
Document.xml：全局文档元数据，包括页面尺寸（pageHeight/pageWidth）、边距、列数、默认字体等； -
DesignMap.xml：整个文档的结构索引，列出所有 story、spread、layer 的引用关系。
例如，页面尺寸就藏在 Document.xml 的根元素里：
<Document ... pageHeight="841.89" pageWidth="595.275" ...>单位是点（points），对应 A4 尺寸（210 × 297 mm）。
IDML XML 的命名空间与关键命名约定
IDML 使用严格命名空间，几乎所有元素都带 idP: 或 idQ: 前缀（如 idP:Story, idQ:TextFrame），这是 Adobe 内部保留命名空间，不能随意删改，否则 InDesign 导入时会报错或静默丢弃内容。
常见易混淆点：
-
Stories/story_1.xml中的idP:Story是容器，真正文本内容在idP:Content下的idP:P（段落）、idP:Span（字符范围）中； - 样式引用不是靠名字，而是靠
appliedParagraphStyle属性中的 ID 引用，例如：appliedParagraphStyle="ParagraphStyle/1"→ 对应Resources/ParagraphStyles/1.xml； - 图片不是内嵌二进制，而是通过
idQ:Image元素指向Resources/Graphics/下的原始文件名（如image_1.jpg），该文件必须存在于包内且路径匹配。
为什么不能直接用普通 XPath 处理全部 IDML XML？
因为 IDML 包含多个相互依赖的 XML 文件，且跨文件引用（如 story 引用 paragraph style，spread 引用 story）是常态。单纯对单个 story_1.xml 执行 //idP:P 可以提取段落，但若想「把某段文字改成红色」，你还得：
- 查出它当前应用的
appliedCharacterStyleID； - 定位到
Resources/CharacterStyles/X.xml； - 修改其中的
fillColor值； - 确保
DesignMap.xml仍能正确定位该 style 资源。
这就是为什么推荐用 SimpleIDML 这类封装库——它自动管理命名空间、ID 映射和跨文件依赖，避免手动维护引用断裂。裸写 lxml + XPath 容易生成 InDesign 拒绝打开的“语法合法但语义无效”的 IDML。
实际调试建议：从 Document.xml 和 Stories/ 入手
日常开发中，90% 的结构探查需求集中在两个地方：
- 查页面设置、版心、页码规则 → 直接看
Document.xml； - 查某段文字内容、样式链、是否含变量或书签 → 进
Stories/找对应 story，搜索idP:Bookmark或idP:Variable元素； - 别一开始就碰
Spreads/：它的坐标系（geometricBounds）是相对父容器的字符串（如"0,0,100,200"），容易因单位/参考系理解偏差导致错位。
记住：IDML 是「可逆导出」格式，不是设计稿快照。InDesign 导出 IDML 时已做了一次抽象（比如把效果转成 ObjectEffect 节点），所以你看到的 XML 是逻辑表示，不是像素映射。想精确还原视觉？得配合 InDesign Server 渲染验证，不能只信 XML 结构。
