# Excel转文件工具

**Repository Path**: picksan/excel-file-conversion-tool

## Basic Information

- **Project Name**: Excel转文件工具
- **Description**: 一个根据配置生成定长数据文件的小工具。
1.读取可注释的配置文件（TOML），解析文件类型/版本/字段定义
2.生成 Excel 模板，供用户填写数据
3.导入已填写的 Excel，按配置生成定长或分隔符数据文件

- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-29
- **Last Updated**: 2026-02-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Excel 转文件工具

## 功能
- 读取可注释的配置文件（TOML），解析文件类型/版本/字段定义
- 生成 Excel 模板，供用户填写数据
- 导入已填写的 Excel，按配置生成定长或分隔符数据文件

## 运行环境
- Python 3.11+
- 依赖：openpyxl


## 创建并启用虚拟环境
### macOS / Linux
```bash
python3 -m venv .venv
. .venv/bin/activate
```

### Windows (PowerShell)
```powershell
python -m venv .venv
.\\.venv\\Scripts\\Activate.ps1
```

### Windows (cmd)
```bat
python -m venv .venv
.venv\\Scripts\\activate.bat
```

## 安装依赖
```bash
python -m pip install -r requirements.txt
```

## 使用
```bash
python app.py
```

1. 选择配置文件（默认 `config.sample.toml`，也可选择一个包含多个配置的目录）
2. 勾选文件类型/版本，生成 Excel 模板
3. 在模板中填写数据
4. 导入 Excel 并生成文件

## Excel 模板说明
- 前 5 行为字段说明：
  - 行1：字段序号
  - 行2：字段长度（长度,小数位）
  - 行3：字段英文名
  - 行4：字段中文名
  - 行5：字段说明
- 前 2 列为控制列：
  - 注释、是否有效
- 数据从第 6 行开始

## 配置文件格式（简化版）
每个文件类型/版本一个独立的 TOML 文件：  
- 顶层字段描述文件属性  
- `fields` 为字符串数组，每行一个字段配置  

字段行格式：  
`序号|字段名|类型|长度,小数位|中文名|说明`  

## 数据格式说明
- C/A：字符型，定长文件左对齐右补空格
- N：数值型，忽略小数点，定长文件左补零右对齐
- 不定长文件使用分隔符（delimiter）分隔字段

## 输出文件
- 文件名：`{文件类型}_{版本}.txt`
- 编码使用配置中的 `encoding`
- 可选输出行数（`show_count`）