企业官网建设流程全解析

简介：面向Delphi开发者的FastReport报表实战资源，聚焦如何将Excel作为数据源接入FastReport并生成动态报表，解决传统报表开发中数据处理与布局设计割裂的问题。压缩包共10个文件，约835KB，内含Delphi工程源码（dpr、pas、dfm）、可运行exe、xls模板及htm、txt说明文档，涵盖数据连接、数据集创建、字段映射到报表预览导出的完整链路，适合正在学习FastReport组件或需要快速搭建Excel驱动报表功能的开发者。已有574人学习下载，资源短小精悍，既有可直接运行的示例，也有可对照修改的源码模板，尤其对理解FastReport中Excel数据源连接和报表元素绑定有直观参考价值。

1. 用Excel做FastReport报表：先让数据离开工作簿，才能谈版式和打印

很多人一听到“用Excel做FastReport报表”，第一反应是拿Excel画线、调样式，其实正好反了。做财务、供应链、运营的人手里永远有一堆整理好的Excel表格——订单明细、库存台账、考勤记录——但真要出周报、月度汇总、发货单，直接在Excel里排版又慢又乱：列宽对不齐、合计算错、发给领导前还要手动调打印区域。FastReport恰好补上这块：它不管数据来自xlsx、数据库还是JSON，只负责把数据按模板渲染成正式报表、汇总、导出PDF或Excel。这条路适合三类人：天天对着Excel做手工报表的业务人员、被要求格式统一的文员、以及Delphi或.NET项目里被客户追着要报表模块的工程师。下面按“数据怎么进、模板怎么画、代码怎么跑、坑怎么躲”的顺序，把这条路完整打通。

2. 为什么是FastReport而不是打印Excel：数据源、模板、渲染三层怎么拆

FastReport做报表的思路其实和前端页面很像：数据是一层，模板是一层，渲染输出是一层。Excel的问题在于这三层全搅在一个文件里——单元格里既有原始数据，又有公式，还有排版样式，改一处牵动全局。FastReport把这三个东西拆开：数据源负责提供内容，fr3模板负责描述每一行、每一列放在哪、合计怎么算，渲染引擎在预览或导出时把两者合到一起。这个拆法带来的直接好处是：Excel文件每周都在变，但fr3模板可以一个月不动；换个数据文件，报表照样工整。

2.1 FastReport读Excel的两种接法：连表与导入

FastReport本身不把xlsx当“数据库”直接查询，它读Excel有两条不一样的路。

第一条是“连表”：通过ODBC或ADO把Excel工作簿当成一个数据库，写SELECT * FROM [Sheet1$]去查数据，FastReport拿到的是一个标准的数据集。这个方式的优点是数据驱动，可以做分组、求合计、按参数过滤，适合业务报表。缺点是Excel里如果有合并单元格、多行表头、空行，查出来的数据会是歪的，需要先清洗。

第二条是“导入”：用FastReport的Excel导入组件，把xlsx文件一页一页读进报表，Excel里是什么样，报表预览里基本就是什么样。这条路适合打印场景——你只是想把这个月做好的Excel对账单批量转成PDF、保留原来的合并单元格和边框线，并不想重新画模板。

两条路不冲突。我一般这样判断：如果要做月度汇总、按客户分组的销售报表，走连表；如果只是把一堆手工表统一导出成PDF存档，走导入。最容易翻车的做法是拿着“导入”的预期去走“连表”的流程，看到数据歪了就开始怀疑FastReport不行，其实是接法选错了。

2.2 把Excel整理成FastReport能用的“表”形状

Excel不是数据库，FastReport也不是Excel的替代品。想让连表查询稳定，Excel文件必须先变成“第一行是字段名、下面每一行都是完整数据”的平表。做不到这一点，后面所有分组、合计都会跟着歪。

最常见的整理动作有几个：把多行表头压成一行，只保留最后一层；取消合并单元格，并保证每一行都有值——用“定位条件”选中空值，输入=上方单元格按Ctrl+Enter批量填充，比一个个复制快得多；删除中间的空行和“小计”行，因为SUM会把它们一起算进去；日期、金额这类列不要拼成“2024年1月”这样的文本，也不要加“￥”前缀，否则FastReport读回的是字符串，求和全是0。这些听起来像Excel基本功，但报表字段对不上、合计对不上时，九成原因是数据没洗平。

顺带提一个热词场景：如果Excel里有多条件筛选的需求，可以在清洗阶段用“筛选→多条件”把脏数据先过滤掉，再做定位和删除，不要让脏数据留在源文件里。数据从源头干净，FastReport这边才不用写一堆补丁脚本。

2.3 单元格格式和数据格式在这里定生死

“能看”和“能算”是两回事。Excel里一个单元格显示成2024/6/1，底层存的是45479；显示成1,234.50，底层存的是1234.5。FastReport走ODBC或ADO读Excel时，读的是底层值，不是显示出来的样子。所以经常发生一种情况：Excel里看起来好好的日期，到了报表里变成了一串数字；金额列看起来有千分位，到了报表里小数没了。

解决办法有两层。第一层在Excel侧：把日期列统一成真正的日期格式（不是文本），金额列设为“数值”保留两位小数，不要用“文本”存储数字。第二层在FastReport侧：给Memo控件设DisplayFormat，日期用yyyy-mm-dd，金额用#,##0.00。这两步都做到，报表才稳定。只改FastReport、不改Excel源数据，下个月换文件还是会踩同一个坑。还有一个小提醒：Excel里公式下拉失效是常见故障，如果你依赖公式列生成汇总字段，建议整列填好值再给FastReport，不要在报表端指望重新计算。

3. 从xlsx到第一张报表：设计器里的十分钟流程

原理讲清楚了，直接动手。FastReport设计器通常内嵌在Delphi/C++Builder环境里，双击设计好的frxReport组件，或者单独打开FastReport Designer，都能进设计界面。第一次做，目标要定小一点：把Excel里的一张订单明细表，变成能打印、能导出的日报表，带上客户分组和金额合计。

3.1 在数据字典里添加Excel数据源：ODBC还是ADO

打开设计器后，左侧会有一个“数据字典”（Data Dictionary）窗口。右键选择“添加数据源”，会看到一堆数据库类型。Excel不是这里的默认选项，需要通过ODBC或者ADO接进去。

在纯设计器环境里不写代码，最直接的做法是加一个ODBC连接：

• 打开Windows的ODBC数据源管理器，添加一个用户DSN。
• 驱动选“Microsoft Excel Driver(*.xls, *.xlsx, *.xlsm)”，注意操作系统位数要和后面的报表程序一致。
• DSN名称填“ExcelReport”，然后指定工作簿的绝对路径。
• 回到FastReport设计器，右键数据字典，添加ODBC数据库，选择刚才的DSN，再选择你要读的工作表。

这里有一个关键点：Excel被当作数据库时，一张工作表就是一张“表”，DSN里的Workbook路径是固定的。如果数据文件路径会变，建议不要用DSN，改用代码方式在运行时传连接串，这个后面第4章会讲。首次接通后，设计器里能看到工作表对应的字段列表，双击字段就能往报表上拖。

3.2 拖字段、连求和、套分组：报表骨架的三种动作

接通数据源之后，做三件事就能搭出骨架。

第一件事是把字段拖到数据区。FastReport的报表结构里，DataBand是数据条带，它绑定数据集后，Excel里每一行数据都会在DataBand里渲染一遍。把“日期、客户、产品、数量、金额”拖到DataBand上，FastReport会自动生成对应的一排Memo控件。

第二件事是加分组。右键DataBand，选择“编辑分组”，按“客户”字段分组。FastReport会生成一个GroupHeader条带，把“客户”字段拖进去，这样每个客户的记录前面会显示一次客户名，不用每行都重复。

第三件事是求和。在分组条带后面加一个GroupFooter，往里放一个Memo，把它的Text设成[SUM(DataSet.金额)]。这样每个客户的小计就出来了。如果要做总计，再在报表尾部放一个同样的SUM，它会统计整个数据集。

这里有两个必调参数：日期的DisplayFormat设成yyyy-mm-dd，金额的DisplayFormat设成#,##0.00。这两个参数不设，你看到的报表就是一堆序列数和长期尾数。另外一个细节：模板保存成.fr3时，不要放在工程的dev目录里，dev目录经常被构建脚本清理，辛苦画的模板会随编译一起被删掉。让模板文件在独立目录只保留一份，代码里用绝对路径或配置项加载。

3.3 把模板保存成fr3：之后每次只要换数据文件

模板画完保存成.fr3，接下来每个月只需要做一件事：换Excel数据文件，重新打开模板预览。FastReport的报表生命周期是：加载fr3模板 → 连接数据源 → 读取数据 → 渲染输出。模板和数据源是分离的，所以换数据文件不需要改模板。

实际使用中，我建议这样组织流程：Excel文件按月份命名，放在一个固定目录；fr3模板只画一次；生成PDF时用FastReport的预览窗口或代码导出。如果数据列名变了——比如上个月叫“客户名称”，这个月叫“客户”——模板里绑定的字段名会失效，预览时显示空。遇到这种情况，优先改Excel的列名匹配模板，而不是改模板去迁就Excel，因为模板是长期资产，Excel往往是临时文件。

提示：第一次做模板时，字段名、类型、空值情况都要和数据文件核对一遍。FastReport对字段名是严格匹配的，差一个空格都认不出来。

4. 让报表跟着Excel走：代码里动态传表、合并多个工作表

设计器适合做固定模板，但实际项目里，Excel文件路径会变、要合并多个Sheet、甚至列数都不固定。这时候需要用代码把Excel数据读出来，塞给FastReport。常见做法是用ADO或TClientDataSet作为中间层，把Excel数据装进内存数据集，再绑定到frxDBDataset上。

4.1 最小Delphi代码：ADO把Sheet读进frxDBDataset

下面这段Delphi代码，是把Excel的一个Sheet读进ADOQuery，再送给FastReport的最小可运行版本：

procedure TForm1.Button1Click(Sender: TObject); begin // 动态生成ADO连接串，指向Excel文件路径 ADOQuery1.ConnectionString := 'Provider=Microsoft.ACE.OLEDB.12.0;' + 'Data Source=C:\ReportData\订单明细.xlsx;' + 'Extended Properties="Excel 12.0 Xml;HDR=YES;IMEX=1;";'; // 读第一个工作表，工作表名要加中括号和$后缀 ADOQuery1.SQL.Text := 'SELECT * FROM [订单明细$]'; ADOQuery1.Open; // 把数据集交给FastReport的DBDataset，再由fr3模板渲染 frxDBDataset1.DataSet := ADOQuery1; frxReport1.LoadFromFile('C:\ReportTemplate\销售日报.fr3'); frxReport1.ShowReport; end;

这段代码里有三个参数是踩坑高发区。HDR=YES表示Excel第一行是字段名，如果你的表头有两行，这个参数会让第二行表头变成字段名，查出来的数据必然错位；IMEX=1表示把混合类型列按文本读，能避免数字和文本混在同一列时读成NULL，但副作用是数字列可能变成文本，求和时要先转换；Excel 12.0 Xml对应xlsx格式，如果是老式xls文件，要改成Excel 8.0。实际项目里我通常会先用Excel的定位条件把数据区整理干净，再让ADO去读，能省掉后面一堆类型转换的麻烦。

4.2 多Sheet合并：循环打开、追加到同字段

实际业务里，三个门店各给一个Excel文件，或者一个文件里三个Sheet，要合并成一张日报。frxDBDataset一次只能绑定一个数据集，不能直接把三个Sheet都绑进去。正确的做法是先合并内存表，再统一交给FastReport。

我一般先用TClientDataSet建一张和目标结构一致的内存表，然后循环打开每个Sheet，逐行追加：

// 假设已经创建了CDS，字段结构与Excel一致 CDS.CreateDataSet; for i := 0 to SheetNameList.Count - 1 do begin ADOQuery1.SQL.Text := 'SELECT * FROM [' + SheetNameList[i] + '$]'; ADOQuery1.Open; while not ADOQuery1.Eof do begin CDS.Append; CDS.FieldByName('门店').AsString := SheetList[i]; // 用Sheet名补充分组字段 CDS.FieldByName('日期').AsDateTime := ADOQuery1.FieldByName('日期').AsDateTime; CDS.FieldByName('金额').AsFloat := ADOQuery1.FieldByName('金额').AsFloat; CDS.Post; ADOQuery1.Next; end; end; // 合并完成后，把内存表交给FastReport frxDBDataset1.DataSet := CDS; frxReport1.LoadFromFile('C:\ReportTemplate\门店日报.fr3'); frxReport1.ShowReport;

这里有两个容易忽略的点。第一，多个Sheet的字段名必须完全一致，字段A和字段A（多了个空格）都会被FastReport当成不同字段，取值时拿到空值。第二，如果要在报表里区分门店，必须在合并写入时用Sheet名或文件名补一个“门店”字段，否则数据全混在一起，没法分组。我见过不少项目在Excel侧做了透视表，到FastReport这边又想展开，结果列数对不上，来回改模板，浪费一下午。

4.3 动态列和动态标题：用脚本撑住变化的表头

Excel表格最常见的问题是“这个月多了一列”。上个月是“一月、二月、三月”，这个月预算那边又加了“四月”。FastReport的fr3模板是静态的，列数是画好的，不会自动增加。

处理动态列，我的原则是：优先在Excel侧把列变成行。比如把每个月作为一行数据，用“日期”字段区分月份，FastReport模板里永远只需要一列“金额”，按月份筛选或分组。这个思路叫“长表”或“反透视”，Excel里用Power Query可以快速把宽表转成长表，做报表的人应该把这个动作练熟。

如果实在没法改数据结构，比如客户给过来的宽表是死格式，那就只能在FastReport里写脚本动态创建Memo。脚本放在fr3的OnBeforePrint事件里，示例大概是这样一个逻辑：

// 在报表脚本中动态创建列标题 var ColHeader: TfrxMemoView; i: Integer; begin for i := 0 to ColumnCount - 1 do begin ColHeader := TfrxMemoView.Create(ReportPages[0]); ColHeader.SetBounds(XOffset + i * ColWidth, 0, ColWidth, 20); ColHeader.Text := ColumnNames[i]; ReportPages[0].FindObject('ColumnHeaderBand').AddObject(ColHeader); end; end;

这段代码的原理是：先算好起始X坐标和列宽，然后在页面上逐列创建Memo，用SetBounds控制位置和宽度。脚本方案能解决燃眉之急，但维护成本高——列数一变，脚本里的坐标、宽度、变量名都要跟着改。所以我仍然建议优先用长表方案，脚本只是最后一根救命稻草。

5. FastReport×Excel的常见问题排查：五个坑和对应解法

Excel做数据源、FastReport做渲染，组合起来会遇到一些“单看Excel没问题、单看FastReport也没问题，合起来就出问题”的情况。下面五个是高频坑，每个都按现象、原因、解决的顺序写。

5.1 64位Delphi连不上Excel文件

现象：ADO打开连接时报“未找到提供程序”，或者ODBC驱动在列表里找不到Excel Driver。

原因：你的程序按64位编译，但机器上只装了32位的Microsoft Access Database Engine，或者ODBC数据源管理器打开的是32位版本。Excel路径和代码都没错，错在进程位数对不上。

解决：确认程序编译目标位数，然后打开对应位数的ODBC管理器——64位是odbcad32.exe的64位版本，32位是控制面板里的“ODBC数据源”。查看“驱动程序”标签页里有没有Microsoft Excel Driver。没有就去安装对应位数的Access Database Engine。装完再重启程序，连接串里用Microsoft.ACE.OLEDB.12.0，一般就能通。如果实在不想装驱动，可以绕过ODBC，用TClientDataSet从代码里把数据读好再给FastReport。

5.2 日期字段显示成数字

现象：Excel里是2024/6/1，FastReport报表里显示成45479，或者显示成2024/6/1 0:00。

原因：Excel日期底层是序列数，ODBC默认按浮点数读给FastReport，FastReport里的Memo并没有自动识别它是日期。

解决：在fr3模板中，选中日期对应的Memo，打开它的DisplayFormat属性，设成yyyy-mm-dd。设完之后预览就正常了。如果多个报表模板都用到日期，建议在Excel侧把日期列设置为真正的日期格式，而不是“文本”，否则ODBC读出来的是字符串，FastReport无法排序和按日期过滤。另外，Excel里不要用“2024.6.1”这种手工输入格式，FastReport不认。

5.3 空值、合并单元格让汇总翻车

现象：合计出来的金额比手工加总少，或者同一个客户的数据在报表里重复出现。

原因：合并单元格在ODBC读出来时，只有合并区域左上角的格子有值，其他格子返回NULL；Excel区域里的空行也会被当成有效记录读进来。FastReport的SUM函数对NULL值的处理是忽略，所以如果有几条记录只有空值，合计自然少了。

解决：数据清洗阶段就要把合并单元格取消掉，用“定位条件→空值→=上方单元格→Ctrl+Enter”把值填满。数据区域不要选整列，只选有数据的范围，避免把空行带进来。这一步做完，合计数对不上、记录数对不上的问题通常会一起消失。

5.4 导出Excel后格式退化

现象：FastReport里预览很漂亮，frxXLSExport导出xlsx后，列宽变了、边框线没了、合并单元格乱掉。

原因：FastReport的报表坐标系和Excel的列宽体系不一样，FastReport按像素排版，Excel按字符宽度排版。导出的本质是“把像素坐标翻译成

本文还有配套的精品资源，点击获取