# auto-gen-excel

**Repository Path**: Hawkc/auto-gen-excel

## Basic Information

- **Project Name**: auto-gen-excel
- **Description**: 基于pyside6的excel模板生成工具
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-11-13
- **Last Updated**: 2025-11-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Excel数据生成工具

## 简介

本工具基于 PySide6 和 openpyxl，支持批量读取 Excel 源数据文件，按模板自动生成多个 Excel 文件。适用于批量合同、报告、发票等自动化填充场景。

![alt text](resource/image.png)

## 主要功能

- 选择源数据 Excel 文件（首行为字段名，后续行为数据）
- 选择 Excel 模板文件（支持 ${字段名} 占位符自动替换）
- 选择输出目录，批量生成 Excel 文件
- 保留模板样式、合并单元格、边框
- 实时进度显示与日志输出
- 支持中途停止

## 依赖环境

- Python 3.7+
- PySide6
- openpyxl
- pandas

安装依赖：
```bash
pip install PySide6 openpyxl pandas
```

## 使用方法

1. 启动 `main.py`：
   ```bash
   python main.py
   ```
2. 在界面中依次选择：
   - 源数据文件（如 `data.xlsx`，首行为字段名）
   - 模板文件（如 `template.xlsx`，单元格可用 `${字段名}` 占位符）
   - 输出目录
3. 点击“开始生成”，等待进度完成。

## 注意事项

- 源数据文件首列内容将作为生成文件名（如 `张三.xlsx`）。
- 模板文件中的 `${字段名}` 会被对应数据自动替换。
- 模板需为 `.xlsx` 格式。
- 生成文件保留模板的所有格式、合并单元格和边框。

## 常见问题

- 如遇到 `unhashable type: 'StyleProxy'` 等错误，请确保 openpyxl 版本为 3.0 及以上。
- 若界面显示异常，请尝试升级 PySide6。

## 许可证

MIT License