# tools001_xlsx-csv

**Repository Path**: chenwl888/tools001_xlsx-csv

## Basic Information

- **Project Name**: tools001_xlsx-csv
- **Description**: No description available
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-27
- **Last Updated**: 2025-10-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Excel to CSV Converter - 软件功能概要

## 📋 软件概述
Excel to CSV Converter 是一款简单易用的Excel文件批量转换工具，具有友好的图形用户界面，能够将Excel文件（.xlsx/.xls格式）批量转换为CSV格式文件。

## 🎯 核心功能

### 1. 文件格式支持
- **输入格式**：支持 .xlsx 和 .xls 格式的Excel文件
- **输出格式**：生成 UTF-8 编码的 CSV 文件，完美支持中文
- **处理范围**：只处理Excel文件的第一个工作表（Sheet1）

### 2. 批量处理
- **批量转换**：一次性处理文件夹中的所有Excel文件
- **自动命名**：CSV文件自动以原Excel文件名命名
- **进度显示**：实时显示转换进度和状态

### 3. 智能路径管理
- **绝对路径显示**：选择文件夹后显示完整绝对路径
- **历史记录功能**：
  - 保存最近使用的10个输入/输出路径
  - 下拉选择框快速选择历史路径
  - 最近使用的路径自动排在前面
- **智能导航**：浏览对话框从当前文件夹或已有路径开始导航

### 4. 配置持久化
- **自动保存**：选择文件夹后立即保存配置
- **程序记忆**：下次启动时自动恢复上次选择的路径
- **配置文件**：使用 config.ini 文件保存所有设置

### 5. 用户界面特性
- **友好界面**：基于 tkinter 的现代化图形界面
- **实时日志**：转换过程实时显示详细日志
- **状态指示**：进度条和状态标签显示当前操作
- **错误处理**：完善的错误提示和异常处理

## 🔧 技术特性

### 1. 依赖管理
- **自动检测**：程序启动时检测必要的依赖库
- **状态显示**：界面显示当前可用的Excel处理库状态
- **兼容性**：支持 openpyxl（.xlsx）和 xlrd（.xls）

### 2. 多线程处理
- **非阻塞界面**：转换过程在后台线程执行
- **界面响应**：转换过程中界面保持响应
- **安全退出**：程序关闭时自动保存配置

### 3. 错误处理
- **文件验证**：检查输入文件夹是否存在
- **路径验证**：验证输出路径的有效性
- **异常捕获**：捕获并显示转换过程中的错误
- **依赖检查**：提示缺失的依赖库

## 📁 文件结构
```
xlsx-csv/
├── excel_to_csv_converter.py  # 主程序源码
├── build_goland.bat          # GoLand环境编译脚本
├── dist/
│   └── ExcelToCSVConverter.exe  # 编译后的exe文件
├── config.ini                # 配置文件（自动生成）
├── data/                     # 默认输入文件夹
└── output/                   # 默认输出文件夹
```

## 🚀 使用流程

1. **启动程序**：双击 ExcelToCSVConverter.exe
2. **选择输入文件夹**：点击"浏览"选择包含Excel文件的文件夹
3. **选择输出文件夹**：点击"浏览"选择CSV文件保存位置
4. **开始转换**：点击"生成CSV"按钮开始批量转换
5. **查看结果**：在日志区域查看转换进度和结果

## ⚡ 性能特点

- **高效处理**：使用原生Python库，处理速度快
- **内存优化**：逐个处理文件，避免内存溢出
- **编码支持**：UTF-8编码确保中文内容正确显示
- **文件安全**：只读取不修改原始Excel文件

## 🛡️ 安全特性

- **只读操作**：不修改原始Excel文件
- **路径验证**：严格验证文件路径的有效性
- **异常处理**：完善的错误处理机制
- **配置安全**：配置文件使用标准INI格式

## 📊 适用场景

- **数据迁移**：将Excel数据导入其他系统
- **批量处理**：大量Excel文件的格式转换
- **数据备份**：将Excel数据备份为CSV格式
- **系统集成**：为不支持Excel的系统提供数据接口

## 🔄 版本信息

- **当前版本**：1.0
- **Python版本**：3.13.7
- **编译工具**：PyInstaller 6.16.0
- **依赖库**：openpyxl 3.1.5, xlrd 2.0.2
- **平台支持**：Windows 10/11

---

**开发环境**：GoLand + Python 3.13.7  
**编译时间**：2025年10月27日  
**文件大小**：约 50MB（包含所有依赖）