3分钟上手！积木报表(JimuReport)零基础安装指南：从下载到可视化大屏

你还在为报表开发繁琐、可视化效果差而烦恼吗？本文将带你3分钟从零开始，完成积木报表(JimuReport)的下载与安装，轻松实现数据可视化报表和炫酷大屏设计。读完本文，你将掌握：

• 积木报表的两种安装方式（源码部署/绿色版）
• 环境配置与初始化步骤
• 首次登录与功能快速体验
• 常见问题解决方案

什么是积木报表？

积木报表(JimuReport)是一款类Excel操作风格的开源数据可视化工具，功能涵盖报表设计、大屏设计、打印设计等，完全免费！秉承"简单、易用、专业"的产品理念，极大降低报表开发难度。

核心特点：

• 在线拖拽设计，所见即所得
• 支持28种图表类型与复杂报表
• 内置大屏设计器，可制作炫酷数据可视化界面
• 支持30+数据库类型，包括MySQL、Oracle、达梦等国产数据库

项目结构概览：

• 核心代码：jeecgboot/jimureport
• 示例项目：jimureport-example/
• 数据库脚本：db/jimureport.mysql5.7.create.sql

安装前准备

环境要求

环境	版本要求	备注
JDK	17+	SpringBoot3架构要求
MySQL	5.7+	需手工执行SQL脚本
Redis	可选	用于缓存和会话管理
Maven	3.6+	源码编译使用

下载方式

方式1：源码下载（推荐开发者）

git clone https://gitcode.com/jeecgboot/jimureport

方式2：绿色免安装版

直接下载打包好的可执行版本，解压即可运行（适合非开发用户）

安装步骤

方法一：源码编译部署

1. 下载源码

git clone https://gitcode.com/jeecgboot/jimureport
cd jimureport

2. 初始化数据库

执行SQL脚本创建数据库和表结构：

# 执行MySQL脚本
mysql -u root -p < db/jimureport.mysql5.7.create.sql

脚本位置：db/jimureport.mysql5.7.create.sql

3. 配置数据库连接

修改示例项目配置文件：jimureport-example/src/main/resources/application-dev.yml

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/jimureport?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8&useSSL=false
    username: root
    password: 123456

4. 编译运行

# 进入示例项目目录
cd jimureport-example

# 使用Maven编译打包
mvn clean package -Dmaven.test.skip=true

# 运行SpringBoot应用
java -jar target/jimureport-example-2.1.5.jar

方法二：Docker快速部署

1. 进入示例项目目录

cd jimureport/jimureport-example

2. 执行Docker Compose

docker-compose up -d

Docker配置文件位置：jimureport-example/docker-compose.yml

首次使用指南

访问系统

服务启动后，通过浏览器访问：

http://localhost:8085

登录系统

默认账号密码：

• 用户名：admin
• 密码：123456

登录控制器源码：jimureport-example/src/main/java/com/jeecg/modules/jmreport/controller/LoginController.java

功能体验

报表设计器

在线拖拽设计报表，类Excel操作风格，支持复杂报表设计：

大屏设计

通过拖拽组件快速设计炫酷数据大屏：

数据可视化

支持多种图表类型，满足不同数据展示需求：

常见问题解决

问题1：启动时报数据库连接错误

解决方法：检查数据库配置是否正确，确保MySQL服务已启动，且SQL脚本已执行。

配置文件位置：jimureport-example/src/main/resources/application-dev.yml

问题2：JDK版本不兼容

解决方法：确保使用JDK17及以上版本，可通过以下命令检查JDK版本：

java -version

问题3：访问页面出现403错误

解决方法：检查安全配置和跨域设置，相关配置文件：

• jimureport-example/src/main/java/com/jeecg/modules/jmreport/config/CustomCorsConfiguration.java
• jimureport-example/src/main/java/com/jeecg/modules/jmreport/satoken/config/SecurityConfig.java

总结

通过本文介绍的方法，你已经成功安装并启动了积木报表(JimuReport)。现在你可以：

• 使用在线设计器创建报表和大屏
• 连接自己的数据源进行数据可视化
• 自定义报表样式和打印格式

官方文档：README.md

如果在使用过程中遇到问题，可以通过项目的issue系统提交问题，或加入QQ交流群获取帮助。

开始你的数据可视化之旅吧！