QtRPT：一个把"报表模板"做成 XML 的 C++

做 Qt 桌面项目，早晚有一天你会遇到这句需求：“这个单据要能打印，最好还能导出 PDF，客户还要能自己改模板。”

到这一步，很多人的选择是打开 QPainter，开始手写 drawText、算坐标、调页边距。第一个月还挺爽，第三个月来个“A4 改成 Letter”、“再加一列”，你就知道什么叫用代码堆排版了。

有没有现成的？有，而且不少。但大多要么闭源收费，要么重到要装一整个报表服务器。今天介绍一个轻的：QtRPT。它就干一件事——把报表排版抽成一个 XML 模板，程序只负责喂数据。

它用的是报表行业用了三十年的 Band 模型。一个 band 就是一条横向的区域，数据来一条，就循环画一遍。工作流很简单：用设计器拖出模板存成 XML，程序里加载这个 XML 灌数据就行。

不过坑也不少。比如商用闭源项目要注意，条码功能依赖的 Zint 库是 GPL 协议，得关掉条码或者开源；还有，千万别假设老 Qt 库能平滑升到 Qt 6，因为 Qt 6 已经移除了它依赖的脚本引擎。

报表这个需求的恶心之处从来不是“画不出来”，而是“需求一直在变”。当排版躺在代码里，每次改动都是一次编译、一次发版；当排版躺在模板里，改一个 XML 就完事了。