如何实现可变长度图文的固定尺寸印刷页面自动排版方案

选型判断 #

• 优先选择PuppeteerSharp封装的无头Chromium批量渲染路径：你此前觉得该工具不适配，本质是未使用低资源的无头批量模式，它是当前所有方案中对动态自适应排版、可变内容适配能力最匹配你需求的选项，可完全实现动态调整字号、图片宽度、最大化利用空间的目标，能稳定支撑19136条数据的批量生产
• 次选路径：基于C#生态iText7原生布局引擎重写排版逻辑，弃用此前使用的HTML/CSS转PDF静态渲染模块，绕开其不支持JS、解析CSS丢样式的缺陷

落地细节 #

无头Chromium渲染方案（低开发量优先选） #

• 资源控制：单无头Chromium实例可循环处理全量条目，单实例内存占用可稳定控制在300MB以内，批量渲染速度可达每秒3-5个页面，全量任务跑完耗时不足2小时
• 尺寸固定：直接通过CSS设置页面输出参数@page { size: 118mm 118mm; margin: 5mm; }，导出的PDF尺寸完全匹配4.7"×4.7"的印刷要求
• 动态排版逻辑：DOM加载完成后自动触发测量逻辑，计算所有内容的总高度与页面可用高度的差值，按比例调整正文字号、图片宽度、列表行高，直到内容刚好填满页面且不溢出、不拥挤
• 溢出处理机制：当内容长度超出页面承载极限时，自动按优先级截断内容，优先保留标题、摘要、主图核心信息，优先压缩长描述、超长文件列表的显示占比，避免版面混乱
• 空间优化：针对短内容条目，自动放大主图尺寸、拉宽松行高填充剩余空间；针对长内容条目，自动收缩字号、压缩元素边距，避免版面拥挤

原生iText7排版方案（无Chromium依赖选） #

• 弃用静态HTML转PDF模块，直接调用iText7原生布局测量API实现自定义排版，所有样式通过API直接设置，完全不存在CSS解析丢失的问题
• 核心实现逻辑：
  • 初始化尺寸为118mm×118mm的固定页面，配置固定印刷边距
  • 逐次将结构化JSON中的标题、摘要、描述、文件列表、图片元素加入画布，每加入一个元素就实时测量已占用的画布高度
  • 当剩余空间不足以承载后续元素时，按优先级调整尺寸：先等比例缩小图片宽度，再逐级下调正文字号、列表行高，直到所有元素适配页面可用空间
  • 当页面存在多余留白时，将剩余空间均匀分配到块元素间距、主图尺寸上，避免无效留白

批量生产注意事项 #

• 全程不要使用写死尺寸的静态CSS渲染模式，必须在渲染流程中嵌入动态测量、动态调整的逻辑，否则无法适配长短差异极大的条目内容
• 批量渲染时不要为每条数据新开一个Chromium实例，复用同一个无头实例加载本地临时HTML模板即可，可将内存占用降低90%以上，避免批量任务中途内存溢出
• 所有图片资源提前做本地缓存，不要在渲染时远程拉取资源，可将整体渲染速度提升3-5倍

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