产品简介
hy.common.report 一个基于Java的报表处理库，旨在简化Excel报表的开发。它允许开发者通过预设的Excel模板和XML配置来定义报表结构，无需编写繁琐的代码即可实现从Java对象到Excel报表的生成，以及反向的Excel数据解析。特别适合Java后端开发人员、需要为业务系统快速生成定制化Excel报表的开发者。
核心功能
- 通过Excel模板与XML配置定义报表，无需编写代码
- 支持Java对象到Excel(.xls/.xlsx)的快速生成
- 支持Excel数据到Java对象的高效解析
- 提供多种复杂报表模板（列表、分页、动态行、小计等）
- 支持图表、二维码、条形码等富文本元素生成
快速开始
- 在项目中引入 hy.common.report 依赖。
- 准备一个Excel文件作为报表模板，并在其中使用“:变量名”格式定义数据占位符。
- 创建XML配置文件，定义模板文件路径、数据起止行等报表结构。
- 在Java代码中，通过 `ReportHelp.toExcel()` 方法将Java对象集合生成Excel报表。
- 使用 `ExcelHelp.save()` 方法将生成的报表工作簿保存为文件。
界面预览
与其他方案对比
| 对比项 | hy.common.report | 同类方案 |
|---|---|---|
| 开发效率 | 通过模板和配置定义报表，代码量极少，修改报表只需调整模板。 | 传统Apache POI手动编码方式，需要编写大量数据填充和格式设置代码，维护成本高。 |
| 功能丰富度 | 内置多种复杂报表模板（动态行、分页页眉、小计），并支持图片、条码等高级元素。 | 功能需自行编码实现，复杂布局和样式实现困难。 |
| 学习成本 | 主要学习如何设计Excel模板和编写XML配置，更贴近最终报表样式。 | 需要深入掌握POI API的细节，如单元格样式、数据区域操作等。 |
适合谁用
- Java后端开发人员，需要为系统快速生成定制化Excel报表
- 企业应用开发者，需要将业务数据（如销售、财务数据）输出为结构化Excel
- 需要处理复杂报表结构（如嵌套列表、分组小计、动态列）的技术人员
下载与版本
当前最新版本为 2026-02-24_3.4.0.S62，发布于 2026-02-25。支持 Windows、macOS、Linux。
⚠️ 注意：本项目仅提供源代码下载，不包含可直接运行的安装包（exe/dmg/apk 等。下载后需要自行编译构建才能使用，适合有一定开发经验的用户。如果你不熟悉编译流程，建议寻找同类开箱即用的替代方案。
注意事项
- 本工具仅供学习和研究使用，请遵守相关法律法规。
- 请尊重内容创作者版权，勿将下载内容用于商业或非法传播。
- 项目源码地址：https://github.com/HY-Org/hy.common.report