# excel_tools

**Repository Path**: loveliulm_admin/excel_tools

## Basic Information

- **Project Name**: excel_tools
- **Description**: excel合并，增量excel合并到底表并自动合并单元格
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-06-02
- **Last Updated**: 2026-06-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 📊 Excel批量合并工具集

包含两个版本的Excel合并工具，专为房产等需要多表增量合并场景设计，支持合并单元格处理、自动去重、新增行标红等特性。

## ✨ 工具列表

| 工具名称                 | 版本   | 功能说明                             |
| -------------------- | ---- | -------------------------------- |
| `excel_merger.py`    | v1.0 | 基础合并版本，支持多Excel文件合并、合并单元格展开、自动去重 |
| `excel_merger_v2.py` | v2.0 | 增强版本，支持增量合并、冲突标红、格式保留、更智能的匹配逻辑   |

## 🚀 核心特性

### 通用特性

✅ 合并单元格自动展开填充，保证每行数据完整  
✅ 不修改任何原始文件，所有操作基于副本，安全可靠  
✅ 自动去重（房号重复自动跳过）  
✅ 支持.xlsx和.xls格式  
✅ 图形化文件选择界面，操作简单无需命令行参数

### v2.0增强特性

✅ 增量表新增行自动标红，方便人工核对  
✅ 支持多Sheet合并  
✅ 保留原始单元格格式  
✅ 更灵活的匹配规则配置  
✅ 合并进度实时显示
✅ 自定义输出路径选择
✅ 自动处理文件重名，生成带时间戳的文件名
✅ 优化的界面布局，操作更直观

## 🛠️ 环境要求

1. Python 3.8+
2. 安装依赖包：
   
   ```bash
   pip install pandas openpyxl xlrd
   ```
   
   （tkinter通常Python自带，如缺失再安装：`pip install tk`）

## 📖 使用方法

### 基础版（v1.0）

```bash
python excel_merger.py
```

1. 第一步选择**底表文件**（主表）
2. 第二步按住Ctrl多选所有**增量表文件**
3. 自动生成合并结果文件

### 增强版（v2.0）

```bash
python excel_merger_v2.py
```

1. **底表选择**：选择主表文件
2. **增量表选择**：添加、删除或清空增量表文件
3. **输出路径选择**：选择合并结果的保存路径
4. **开始合并**：点击开始按钮执行合并操作
5. **查看进度**：处理进度条显示合并进度
6. **查看日志**：日志窗口显示详细的处理过程

## 📤 输出文件说明

1. **合并表-日期.xlsx**：合并后的完整数据，保留底表的标题和表头格式
2. **原始增量表**：在原始增量表中直接标记新增行（红色底色）
3. **原始文件**：所有选择的底表和增量表都不会被修改，完全安全

## ⚙️ 规则说明

1. **表格格式**：
   - 第一行为表格说明，不作为数据，但最后形成表格时需要保留
   - 第二行为表头，包含列序号/区域/户型/房间号等

2. **数据清洗**：
   - 删除房间号列为空的行
   - B列和C列取消单元格合并，空数据向前填充

3. **合并逻辑**：
   - 取增量表中表头以下的数据，与底表中的数据对比
   - 对比字段为B列区域，C列户型，D列房间号
   - 三者完全一致的，不做处理
   - 区域/户型一致，但房间号不一致的数据，在原始增量表中标记红色底色，并将数据复制出来插入到底表的同区域/户型的最下方

4. **合并后处理**：
   - 生成合并表，名称为"合并表-当前日期"
   - 对该合并表进行单元格合并，先合并B列区域一致的，区域合并完成后，合并C列户型一致的
   - A列第三行开始向下自增数字，直到数据的最后一行
   - 表头单元格为黄底，单元格内字体为黑体

## 📝 注意事项

1. 建议使用.xlsx格式，性能更好
2. 表格第一行必须是标题，第二行必须是表头
3. 空行和缺少必填字段的行自动跳过
4. 合并大量文件时建议分批处理，避免内存占用过高

## 🤝 常见问题

### Q: 合并后的数据不全？

A: 检查所有表格是否都包含`区域`、`户型`、`房号`这三个必填列，列名必须完全一致。

### Q: 新增行没有标红？

A: 请使用v2.0版本，基础版不支持标红功能。

### Q: 合并单元格没有展开？

A: 检查合并单元格所在列是否是`户型`列，其他列的合并单元格也会自动展开。

### Q: 输出文件路径如何设置？

A: 在v2.0版本中，可以通过"输出路径选择"功能自定义保存路径。

### Q: 如何处理文件重名？

A: 程序会自动检测文件重名情况，生成带时间戳的文件名。