# codebuddy-javafx

**Repository Path**: stormlong/codebuddy-javafx

## Basic Information

- **Project Name**: codebuddy-javafx
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-23
- **Last Updated**: 2025-06-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Excel 文件比对工具

一个基于JavaFX的Excel文件比对工具，用于比对和分析Excel文件中的数据差异。

## 功能特点

- 📊 支持单文件比对：可以选择基准文件和比对文件进行一对一比对
- 📁 支持批量文件处理：可以选择文件夹，按日期范围批量处理多个Excel文件
- 🔍 数据查看与搜索：
  - 分别展示一致和不一致的数据
  - 支持数据搜索和过滤
  - 可以导出比对结果到Excel文件
- 📅 日期范围处理：支持选择开始和结束日期，处理指定日期范围内的文件
- 💾 数据管理：支持清除已加载的数据
- 📑 多工作表支持：可以选择和切换不同的工作表进行比对

## 系统要求

- Java 17 或更高版本
- Maven 3.6 或更高版本

## 技术栈

- JavaFX 21.0.7 - UI框架
- Apache POI 5.4.0 - Excel文件处理
- Logback 1.5.13 - 日志记录
- Maven - 项目管理和构建

## 快速开始

1. 克隆项目到本地：
```bash
git clone [项目地址]
```

2. 使用Maven构建项目：
```bash
mvn clean package
```

3. 运行应用程序：
```bash
java -jar target/javafx-1.0-SNAPSHOT.jar
```

## 使用说明

### 单文件比对

1. 点击"文件" -> "文件上传"
2. 选择并上传基准Excel文件
3. 选择并上传需要比对的Excel文件
4. 系统会自动进行比对并显示结果

### 批量文件处理

1. 在文件上传界面下方找到"批量文件处理"区域
2. 选择开始日期和结束日期
3. 选择包含Excel文件的文件夹（文件名格式要求：yyyyMMdd.xlsx）
4. 点击"处理并比对"按钮开始批量处理

### 查看比对结果

1. 点击"文件" -> "查看数据"
2. 使用顶部的工作表下拉菜单选择要查看的工作表
3. 在"一致数据"和"不一致数据"标签页之间切换查看结果
4. 使用搜索框筛选数据
5. 使用"导出Excel"按钮导出当前视图的数据

## 项目结构

```
src/main/java/com/example/javafx/
├── HelloApplication.java  # 应用程序入口
├── HelloController.java   # 主控制器
└── ExcelRow.java         # Excel行数据模型

src/main/resources/
├── hello-view.fxml       # JavaFX界面布局
└── logback.xml         # 日志配置
```

## 免费图标库

https://igoutu.cn/

## 开发说明

### 构建项目

项目使用Maven进行构建，主要命令：

```bash
# 清理并构建项目
mvn clean package

# 运行项目
mvn javafx:run
```

### 主要类说明

- `HelloApplication`: 应用程序入口点，负责初始化JavaFX应用程序
- `HelloController`: 主控制器，包含所有UI交互和业务逻辑
- `ExcelRow`: 数据模型类，用于表示Excel文件中的一行数据

## 日志

应用程序使用Logback进行日志记录，日志文件位于`logs`目录下。

## 许可证

[添加许可证信息]

## 贡献指南

[添加贡献指南]

## 联系方式

[添加联系方式]