简介：ReportMachine 7.0 是一套面向 Delphi 开发者的专业报表控件，当前版本支持 Delphi 5 至 XE12，并针对 Delphi 12.3 特别适配。它可帮助程序员在项目中快速实现报表设计、数据打印、导出与预览等功能，适用于企业管理软件、财务统计及票据输出等场景。资源包共包含 723 个文件，压缩后仅 1.52MB，内部主要提供 pas 源码、dfm 窗体布局、dpk/dproj 工程文件以及 res/rc 资源文件，还附带了 bat 构建脚本和多个 Delphi 版本的分组工程，便于在不同 IDE 环境中直接编译安装。目前已有 104 人下载学习。通过这套包，您可以获得完整的报表引擎源码和设计器，能够根据业务需求深度定制报表样式与打印逻辑；同时，多版本工程组织方式也大大降低了控件在不同 Delphi 版本间的迁移成本。对于正在寻找成熟报表解决方案的 Delphi 12.3 用户，这是一个值得直接使用的工具包。
1. 先把这个压缩包讲明白：ReportMachine 7.0 到底是干什么的
做 Delphi 老项目维护的人，几乎都见过 ReportMachine 这个名字。它是一套老牌的 VCL 报表控件，和 FastReport 同时代，但在国内 ERP、进销存、财务系统里的装机量相当高。标题里的“ReportMachine 7.0 for D5-XE12”意思是这套控件支持从 Delphi 5 一路到 Delphi 12 的几乎所有 Win32 版本，“HH 24.9.29.7z”只是打包日期和压缩格式。你真正要解决的是：新装了 Delphi 12.3，但手头的老系统还依赖 ReportMachine 的 .tmr 报表模板，怎么把它装进新 IDE、继续改模板、继续出打印和导出。这篇文章就是给被老项目绑定的开发者看的，准备从旧 Delphi 迁到 12.3 的团队也能按这套流程走。
2. 为什么在 Delphi 12.3 里还要选 ReportMachine：与 FastReport/自带报表的取舍
2.1 ReportMachine 与 FastReport 的核心差异
很多人在选型时第一反应是“为什么不用 FastReport”。说实话，FastReport 现在的生态确实比 ReportMachine 活跃，社区版也在更新，但我见过太多团队在迁移项目时踩进“用完 FastReport 再改模板”的坑里。不是说 FastReport 不好，而是两家在设计理念上差别很大，导致迁移成本被严重低估。
ReportMachine 早期主打的是“类 Excel 的对象模型”，页面上摆的是 Band、Text、DBText、Shape 这些基本对象，你像搭积木一样把报表搭出来。FastReport 则从很早就引入了脚本引擎，报表里能写 Pascal 逻辑，动态控制对象的可见性和数据填充。对纯列表式单据，比如送货单、发票、工资条，ReportMachine 的 Band 设计比 FastReport 更直白，新人半天就能上手；但对交叉表、多层分组、动态列这类复杂场景，FastReport 的脚本优势会明显得多。
从分发角度说，ReportMachine 是纯 VCL 控件，编译时可以直接把代码静态链接进 exe，发布时不需要额外带一堆 BPL 和 DLL。FastReport 虽然也能静态链接，但组件包更庞大，如果项目里有多个版本还容易产生包冲突。我维护过的一个旧财务系统，就是一直用 ReportMachine 7 静态编译，部署到客户机器上只扔一个 exe 加数据库配置就能跑，这种省心程度是很多现代控件做不到的。
还要看数据源绑定方式。ReportMachine 自带 TRMTable、TRMDataSource、TRMDBText 这一整套组件，可以直接连 BDE、ADO、Zeos，也可以包一层 TDataSet 接口。新版对 FireDAC 的支持也补上了。如果你的老项目正从 BDE 往 FireDAC 迁，ReportMachine 是一个比较温和的过渡方案——模板里的 DBText 不需要改，只要换数据源组件就行。
2.2 D5-XE12 跨越二十年的兼容性意味着什么
标题里的 D5-XE12 不是噱头。Delphi 5 发布在 1999 年，Delphi 12.3 是 2023 年之后的东西，中间隔着 20 多年。一个控件能在这两代 IDE 之间用同一套源码编译，说明它的源码里有大量条件编译，类似{$IF CompilerVersion >= 30}这样的分支塞满了每个关键单元。这对维护老项目是好事：你在 Delphi 7 上写好的 .tmr 模板，拿到 Delphi 12.3 里打开，版式基本不变。
但反过来，这种“兼容性广泛”也有很多暗坑。因为条件编译分支多，安装时如果 IDE 版本识别变量没有对号，编译器可能选到错误的单元，报出一堆莫名其妙的错误。比如“找不到 RM_Types.dcu”或者“E2003 Undeclared identifier”。通常这种情况不是控件坏了，而是你打开的 DPK 不对。ReportMachine 的发布包一般会按 IDE 版本拆多个 .dpk 文件，比如文件名里带 d5、d7、d10、d12 或者对应的 IDE 内部版本号，你要挑和 Delphi 12.3 匹配的那一个，不能手滑打开 XE8 的包然后指望它能直接编译。
另一个兼容性问题是位宽。Delphi 12.3 里新建项目默认是 Win32 或者 Win64，ReportMachine 7.0 这种老控件大多是 32 位时代写的。虽然源码能在 Win64 下重新编译，但如果你项目里还引用了某个没有 64 位版的第三方库，最后整个 exe 只能按 32 位发。所以在 12.3 里装组件时，我一般会直接把 IDE 的 Target Platforms 切到 32-bit Windows 来编译控件包，避免运行时 dcu 和当前平台不匹配。
2.3 什么时候该继续用 ReportMachine 而不是迁移
判断是否需要迁移，不要听厂商宣传，直接看资产。我一般建议团队先做一次报表资产盘点：打开老项目的目录，搜一下 *.tmr 或者 *.rmf 文件，统计数量；再抽两三张最复杂的报表，看看里面是否用了大量脚本和复杂分组。走这三步，结论基本就出来了。
第一步，统计 .tmr 模板数量。我见过一个客户，系统里有 400 多张报表模板，全是用 ReportMachine 做的。这种盘子，换 FastReport 意味着每张模板都要重画，哪怕有转换工具也只能转字段位置，脚本逻辑、格式调整全得人工过。按一个人一天处理 5 张模板算，那就是 80 个工作日，还没算测试。有这时间，不如把报表模块的扩展性能和打印质量打磨好。
第二步，看报表里有没有高度依赖 ReportMachine 的事件。比如在 band 的 OnBeforePrint 里写数据清洗逻辑，或者在报表里做动态列。这些逻辑在 ReportMachine 里能跑，不代表搬到 FastReport 里同样写法也能跑。如果项目里大量存在这类“黑匣子”，迁移风险就是成倍上升的。
第三步，想清楚未来目标平台。ReportMachine 是 VCL-only 控件，不支持 FireMonkey，更不支持 Linux 和移动端。如果你的产品已经决定走跨平台路线，那没啥可纠结的，直接用 FastReport FMX 或者 RBuilder 这类跨平台控件。反过来，如果产品就是 Windows 桌面端，没有跨平台的硬需求，那 ReportMachine 的维护成本其实非常低——一个包、一套模板、一个 exe，稳定运行十年没问题。
所以我的结论是：别跟风迁移。报表控件对业务系统来说是基础设施，追求的不是技术时髦，而是“改一个字段位置能半小时内交付”。ReportMachine 在 Windows 桌面这个细分场景里，依然是值得继续投入的选择。
3. 把 24.9.29 版装进 Delphi 12.3：解压、编译、注册一条龙
3.1 解压 .7z 并核对包内结构
拿到“HH 24.9.29.7z”这个文件，第一步是解压。Windows 自带的资源管理器能解 .zip，但 .7z 不一定行，一般用 7-Zip。打开命令提示符，执行：
7z x "ReportMachine 7.0 for D5-XE12 HH 24.9.29.7z" -oD:\Dev\Components\RM7 -y这行命令的意思是：7z x表示解压并保留目录结构；-oD:\Dev\Components\RM7指定解压到该目录，注意-o后面没有空格；-y表示遇到覆盖询问时自动同意。解压完成后，先别急着打开 Delphi，进目录看整体结构。典型的 ReportMachine 包会包含Source、Packages、Lib、Templates这几个常见目录，部分版本还会带Demo和Help。
关键要找的是.dpk文件。你会在Packages里看到一坨类似RM_D5.dpk、RM_D7.dpk、RM_D12.dpk这样的文件，有些还区分运行时包和设计时包。Delphi 12.3 对应的文件名带d12或者 IDE 内部版本号330，有的版本也会写成RM_120.dpk。如果包内命名不规范，你就直接看文件修改时间，选最新的那组。
这里有一个血泪经验：不要直接用鼠标双击 .dpk 来打开。双击会让系统默认关联到已经安装的 Delphi 版本，如果机器上同时装了 Delphi 10.4 和 12.3，双击可能打开错了 IDE。正确做法是打开 Delphi 12.3，在 IDE 里通过 File > Open Project 去选择目标 .dpk。
3.2 用 Delphi 12.3 打开项目包的安装步骤
进入 Delphi 12.3 后，按照先运行时包、后设计时包的顺序操作。如果包目录里只有一个 .dpk，那它既是运行时也是设计时，直接编译安装即可；如果有两个，一般命名会带_R（RunTime）和_D（DesignTime）。
先打开运行时包，比如RM_D12_R.dpk。在 Project Manager 窗口里双击它，然后右键选择Compile。编译成功后，再打开设计时包RM_D12_D.dpk，右键选择Install。IDE 会提示组件注册成功，并告诉你加载到了哪个面板。如果没有 Project Manager 窗口，从 View > Project Manager 打开。
接下来配置 Library Path。菜单 Tools > Options > Language > Delphi > Library，找到Library path，把之前解压目录里的Source子目录加进去，如果有Lib目录也一起加。这一步是让编译器能找到 RM 的 .dcu 文件，不加的话编译任何引用 RM 的工程都会报“找不到文件”。注意平台选择，建议选32-bit Windows，等 32 位包编译无误后再按需切 64 位重编。
还有一个容易忽略的细节：包编译前要确认Runtime Packages选项。在 Project Manager 里右键包工程，选择 Options，看Build with runtime packages。如果你不打算随程序分发 BPL 文件，就保持默认不开，让控件静态链接进 exe。开了反而会在发布时要求带上对应的 BPL，老项目最容易在这里翻车。
3.3 编译安装后如何确认组件面板出现
安装完成后，新建一个 VCL 项目：File > New > VCL Application。Delphi 12.3 默认会创建一个空窗体，这时候在窗体上放一个按钮，为下一步测试做准备。然后在组件面板上找RM标签页，如果找不到，右键面板选择Components，在过滤器里输入 RM。正常情况下你能看到 TRMReport、TRMPage、TRMBand、TRMText 这一系列组件。
拖一个 TRMReport 到窗体上，双击它，如果报表设计器能正常打开，说明控件核心机制已经跑通。接着写一行最简单的代码，比如RMReport1.PreviewModal;（假设你用的 TFMX? 不，VCL），编译运行，能出一个空白的打印预览窗口，安装就算完全成功了。
有些版本安装后组件面板不刷新，需要重启 IDE，这不算失败。但如果重启后依然没有 RM 页，大概率是设计时包没编译成功。你可以到 Project Manager 里重新打开 .dpk，确认下方 Output 窗口有没有红色的 Error 信息。常见错误之一是缺RM_Editor.dcu，说明 Source 路径没加全。解决方法是把整个报表源码目录都加进 Library path，不要只加某一个子目录。
4. 在 Delphi 12.3 里跑通第一张报表：从设计器到代码调用
4.1 报表设计器界面与数据源绑定
把 TRMReport 拖到窗体后，双击进入报表设计器。设计器界面和 FastReport 很像，左边是对象树，中间是页面，右边是属性面板。最核心的概念是 Band，也就是带区。一个最简单的报表通常有报表标题带、明细带、页脚带。明细带里的内容会跟着数据源逐行重复打印，这是报表和普通表单的本质区别。
数据源绑定有两种方式。第一种是可视化绑定：从组件面板拖一个 TRMDataSource 放到窗体上，再拖一个 TADOQuery 或 TFDQuery，把查询的 SQL 写好、激活，然后把 TRMDataSource 的 DataSet 属性指向这个 Query。接着回到报表设计器，在明细带里放一个 TRMDBText，把它的 DataSource 设置为 TRMDataSource，DataField 设置为要显示的字段名。第二种是代码绑定，适合动态生成的报表。
这里有个常见坑：TRMDataSource 不一定能直接接受 TFDQuery。如果新版里没有对应的 FireDAC 桥接单元，你可以用一个标准的 TDataSource 中转，把 TDataSource.DataSet 指向 TFDQuery，再让 TRMDataSource.DataSet 指向 TDataSource。虽然绕了一层，但老模板不需要改，是最省事的兼容方案。
4.2 用代码动态生成报表的最小示例
有时候不想在 Form 上拖控件，希望完全用代码生成报表，比如批量打印时动态改列。下面是最小可运行的例子：
procedure TForm1.BuildReport; var LReport: TRMReport; LPage: TRMPage; LDetail: TRMBand; LText: TRMText; begin LReport := TRMReport.Create(nil); try LPage := TRMPage.Create(LReport); LPage.ParentReport := LReport; LPage.PageWidth := 2100; // 单位是 0.1mm，A4 宽 210mm LPage.PageHeight := 2970; // A4 高 297mm LDetail := TRMBand.Create(LPage); LDetail.BandType := btDetail; // 明细带，数据行重复 LDetail.Top := 20; // 顶部坐标，单位 0.1mm LText := TRMText.Create(LDetail); LText.Parent := LDetail; // 让文本对象挂在带区上 LText.Left := 10; LText.Top := 5; LText.Width := 60; LText.Height := 10; LText.Text := 'Hello ReportMachine'; LReport.PreviewModal; // 弹预览窗口 finally LReport.Free; end; end;先看几个关键参数。TRMPage.Create(LReport)创建页面，ParentReport := LReport是把页面挂到报表下，少了这一句页面不会显示。BandType := btDetail是细带，实际打印时每行数据会重复这个带区。坐标单位 0.1mm 是 ReportMachine 的一贯约定，PageWidth := 2100就是 A4 纸的 210mm 宽，如果你想做 80mm 热敏小票，就写 800。LText.Parent := LDetail要注意，文本对象必须挂在 Band 下面，不是挂在 Page 下面，很多初学者会在这里翻车，编译没错但预览一片空白。
这个例子没有数据源，所以只打一行文字。要显示数据库字段，把 LText 换成 TRMDBText，然后给它设置 DataSource 和 DataField。其余布局代码一模一样。动态生成报表的好处是你可以在循环里按需创建多个 Band 或 Text，比如根据订单明细条数拼出不同行数的小票。
4.3 打印、预览与导出 PDF/Excel 的参数设置
报表做出来就是为了出纸或出文件。预览用PreviewModal或ShowReport都可以，区别是PreviewModal会阻塞直到用户关闭预览窗口，适合按钮点击场景。打印可以直接调Print，但更好的做法是先Preview让用户选打印机。
导出是实际业务里最关心的功能。ReportMachine 7.0 通常自带导出单元，比如RMExportPDF、RMExportXLS。PDF 导出在中文环境里要特别注意字体映射。常见做法是：
uses RM_Common, RM_Report, RMExportPDF, RMExportXLS; procedure TForm1.ExportPDF; var RMExportPDF1: TRMExportPDF; begin RMExportPDF1 := TRMExportPDF.Create(nil); try RMExportPDF1.Report := RMReport1; RMExportPDF1.FileName := 'D:\Output\单据统计.pdf'; RMExportPDF1.ExportType := etPDF; RMExportPDF1.FontSubstitution := True; // 开启字体替换 RMExportPDF1.ExportToFile; finally RMExportPDF1.Free; end; end;FontSubstitution := True是导出 PDF 中文不乱码的关键。如果不设置，默认按模板里的字体名去 PDF 引擎里匹配，而服务器或客户机器上未必装了那张报表用的中文字体。置 True 后控件会用自己的字体资源替换，兼容性更好。Excel 导出类似，用 TRMExportXLS，注意ExportType要选etExcel，而不是etText或etCSV。新版 Office 对老格式 xls 有兼容性提醒，但实际业务中 xls 比 xlsx 更能被老财务系统接受，所以一般保留 xls。
5. 避坑 / 常见问题：老项目迁移到 Delphi 12.3 的五个踩坑记录
5.1 现象：组件面板里找不到 ReportMachine 页，安装时报“找不到包”
现象：按正常流程编译和安装后，组件面板没有 RM 页；或者在安装设计时包时弹窗提示“Cannot load package ... 找不到指定的模块”。
原因：绝大多数情况是运行时包和设计时包没有按顺序编译，或者 Library path 没设置。另一种更隐蔽的原因：机器上装了多个 Delphi 版本，安装时指定到了旧版 IDE 的库目录，12.3 根本读不到。
解决：先删除一切已安装过的 RM 包痕迹，重新打开_R.dpk编译，成功后再打开_D.dpk安装。到 Tools > Options > Library 里把 Source 目录放在列表最前面。最后重启 IDE，强制刷新组件缓存。如果还不行，手工删掉%APPDATA%\Embarcadero\BDS\22.0\*.*proj里的旧工程缓存，再重来一遍。
5.2 现象：报表模板打开后中文乱码，预览和打印都是方块
现象：模板里字段内容明明是中文，预览窗口里显示成“?????”或者下划线方块。导出 PDF 后更明显。
原因：模板保存时用的是旧系统里的字体名，比如“宋体”，但目标机器没有宋体；或者字形名称在 Delphi 12.3 的默认字体映射里找不到。Delphi 12 的默认 UI 字体改成了 Windows 10 以后的新字体，很多老模板就中招。
解决：在报表设计器里全选对象，统一改 Font.Name 为“微软雅黑”或“Tahoma”。更彻底的做法是在 TRMReport 的 OnLoad 事件里做一次字体映射，把老字体名替换为新字体名。这样模板文件不动，加载时自动纠偏。导出 PDF 时要记得把 TRMExportPDF 的 FontSubstitution 设为 True，否则就算屏幕上正常，PDF 里还是乱码。
5.3 现象：Delphi 12.3 编译项目报内存错误
现象：项目编译到一半，弹出“EOutOfMemory”或者“Access violation”，错误位置指向 RM 的某个单元。代码本身没改过，换回 Delphi 7 又是好的。
原因：这一般不是控件泄漏内存，而是 64 位编译模式下，老控件里某些指针整型转换不兼容。也可能是同时加载了多个版本的 RM 包，链接器重复注册资源导致内存冲突。
解决：打开 Project Options，把 Target Platform 切到 32-bit Windows，先保证能编译。然后在 Instantiations 里确认只加载了一个 RM 包。最后在 Project Manager 里右键选择 Build 而不是 Compile，做一次全量重建，清掉旧的 .dcu。我在 Delphi 12.3 上遇到这类问题，90% 是平台位宽和包重复导致，不是代码逻辑问题。如果还是报错，把所有第三方包全部关掉，单独编 RM 项目验证，排除与其他组件的顺序相关性。
5.4 现象：FireMonkey 项目里无法使用，提示“VCL 组件不能放置在此窗体”
现象：新建的是 FireMonkey（FMX）多设备项目，从组件面板里拖 TRMReport 到窗体上，IDE 直接报错禁止放置。或者编译时提示找不到 VCL 平台单元。
原因：ReportMachine 是 VCL-only 控件，它的实现依赖 Win32 窗口句柄、画布和打印机 DC，跟 FireMonkey 的跨平台框架完全不兼容。Delphi 12 的 FireMonkey 源码和 VCL 是两个不同的 UI 体系，不能在同一个窗体里混合。
解决：没有魔法。要么把报表模块独立成一个纯 VCL 项目，作为客户端单独发布；要么换支持 FMX 的报表控件。如果你目标是 Linux 上的进程内报表，ReportMachine 这条路走不通，只能放弃。建议在项目选型阶段就把这条路划掉，别等到 UI 搭完才发现报表模块是死路。
5.5 现象：导出 Excel 后文件打不开或数据不完整
现象：用 RMExportXLS 导出成功，但客户拿到的 .xls 文件打开时提示文件损坏；或者打开后某些列是空的。
原因：常见原因是导出模式选错。有些旧版本 RM 的导出单元默认以 HTML 流伪装成 xls，Excel 新版会拒绝打开。另一个原因是数据源里的字段类型和导出设置不匹配，比如大整数字段、日期字段在 xls 里被截断。
解决：先把 ExportType 明确设置成 etExcel，不要用默认值。如果还打不开，改为导出 CSV 验证数据完整性。导出时设置RMExportXLS1.ExportFormat := efExcel2003或者对应你客户 Office 版本。日期字段建议在 SQL 里TO_CHAR成字符串再输出，避免 Excel 的日期序列号把你数据改掉。这招是干活里的“后悔药”，虽然丑，但最稳。
6. 值不值得继续投入：升级路径与我的自检清单
6.1 什么时候换掉它
如果你问我，ReportMachine 7.0 在 Delphi 12.3 里还能用多久，我的回答是：还能稳定用很多年，但你要给自己留退路。上面的安装和避坑流程，其实就是继续投入的基础。真正该换的信号有三个：一是产品开始要求 macOS/Linux 客户端；二是团队里没人愿意再学 TDataSet 那一套老绑定方式；三是报表模板里开始出现大量动态列和复杂图表，需要脚本引擎。碰到这些，尽早换 FastReport FMX 或者 RBuilder 这类跨平台方案，越拖成本越高。如果只是 Windows 桌面程序，报表以单据、台账、汇总表为主，那继续用 ReportMachine 是性价比最高的决定。
6.2 我个人的验收习惯
每次在一台新环境上装完 ReportMachine，我都会跑一遍四步自检：第一步，新建 VCL 项目拖一个 TRMReport，双击打开设计器，确认没有异常弹窗；第二步，跑一次 4.2 里的动态报表代码，确认能预览；第三步，放一个真实的 TFDQuery，查询一条中文数据，绑到明细带，预览打印；第四步，分别导出 PDF 和 Excel，打开检查字体、列宽、日期格式。这四步跑通，我才敢把老项目往 Delphi 12.3 上迁。这些年我养成的习惯是：不轻易升级控件版本，升级前一定对比新旧包在模板加载、字体渲染上的行为差异。哪怕是小版本升级，也要用真实模板做回归，不能只看 Demo。ReportMachine 这种老控件，最大的价值不是新功能，而是稳定。希望这些踩坑记录能帮你在迁移时少走一段冤枉路，一次把包装干净，把报表模块像老黄牛一样继续跑下去。
本文还有配套的精品资源，点击获取
