# excelmerge

**Repository Path**: qian-szjs/excelmerge

## Basic Information

- **Project Name**: excelmerge
- **Description**: 一个专注于Excel文件合并与处理的开源项目，支持多文件批量操作，简化数据整合流程，提高工作效率。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-12-24
- **Last Updated**: 2025-12-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Excel合并工具

一个支持Excel表格多Sheet合并和多工作簿合并的工具，提供命令行和Web两种使用方式。

## 功能特性

### 1. 单个工作簿多Sheet合并
- 将一个Excel文件中的多个Sheet合并为一个Sheet
- 支持自定义表头行数
- 自动删除重复表头
- 添加`source_sheet`列标识数据来源
- 跳过空Sheet

### 2. 多个工作簿合并
- 将多个Excel文件的Sheet合并到一个文件
- 保留多个Sheet，Sheet名格式：`原文件名_原Sheet名`
- 跳过空Sheet

### 3. 支持的使用方式
- 命令行工具
- Web应用界面（扁平化苹果风格设计）

## 环境要求

- Python 3.8+（支持Windows 7系统）
- 依赖库：见requirements.txt

## 安装依赖

```bash
# 使用pip安装依赖
pip install -r requirements.txt
```

## 使用方法

### 1. 命令行工具

#### 单个工作簿合并
```bash
python excel_merge.py --mode single --input 文件名.xlsx --output 输出文件名.xlsx

# 指定表头行数
python excel_merge.py --mode single --input 文件名.xlsx --output 输出文件名.xlsx --header-rows 2
```

#### 多个工作簿合并
```bash
python excel_merge.py --mode multiple --input 目录名 --output 输出文件名.xlsx
```

### 2. Web应用

```bash
# 启动Web服务器
python app.py
```

然后在浏览器中访问：http://127.0.0.1:5000

#### 使用步骤
1. 选择合并模式（单个工作簿/多个工作簿）
2. 设置表头行数（仅单个工作簿模式）
3. 上传Excel文件（支持拖拽）
4. 点击"开始合并"按钮
5. 合并完成后自动下载结果文件

## 文件说明

- `excel_merge.py`：命令行工具主文件
- `app.py`：Web应用主文件
- `templates/index.html`：Web应用前端界面
- `requirements.txt`：依赖库版本说明
- `uploads/`：上传文件的临时存储目录

## 兼容说明

- 支持Windows 7系统
- 支持Python 3.8及以上版本
- 支持.xlsx格式的Excel文件
- 支持最大16MB的文件上传

## 注意事项

1. 请确保上传的Excel文件格式正确
2. 大文件合并可能需要较长时间
3. 合并过程中请勿关闭浏览器或终端
4. 合并完成后，请及时保存结果文件

## 示例

### 单个工作簿合并
```bash
python excel_merge.py --mode single --input test_single.xlsx --output 合并结果.xlsx
```

### 多个工作簿合并
```bash
python excel_merge.py --mode multiple --input test_files --output 合并结果.xlsx
```

## 技术栈

- Python 3.8+
- Flask 框架
- pandas 库（Excel数据处理）
- openpyxl 库（Excel文件读写）
- HTML5 + CSS3 + JavaScript（前端界面）

## 许可证

MIT License