# python_tools

**Repository Path**: atnx/python_tools

## Basic Information

- **Project Name**: python_tools
- **Description**: 实用python工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-22
- **Last Updated**: 2025-10-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Python自动化工具集

这是一个实用的Python自动化工具集合仓库，包含各种日常办公和文件处理的自动化小工具。

## 📚 工具列表

### 1. 文件分类整理工具 (`file_organizer.py`)

一个智能的文件分类整理工具，可以自动将文件夹中的文件按类型分类到不同的子文件夹中。

**主要功能：**
- ✅ 自动识别9大类文件类型（图片、文档、表格、演示、压缩包、视频、音频、代码、可执行文件）
- ✅ 支持50+种常见文件格式
- ✅ 预览分类功能，查看整理前的统计信息
- ✅ 智能处理重名文件，自动添加序号
- ✅ 详细的整理报告

**使用方法：**
```bash
python3 file_organizer.py
```

**操作步骤：**
1. 运行程序，弹出图形界面
2. 点击"选择文件夹"选择需要整理的文件夹
3. 点击"预览分类"查看分类统计（可选）
4. 点击"开始整理"执行文件分类
5. 文件将被移动到对应类型的子文件夹中

**文件分类规则：**
- 📁 图片：jpg, png, gif, svg, webp 等
- 📁 文档：pdf, doc, docx, txt 等
- 📁 表格：xls, xlsx, csv 等
- 📁 演示：ppt, pptx, key 等
- 📁 压缩包：zip, rar, 7z 等
- 📁 视频：mp4, avi, mkv 等
- 📁 音频：mp3, wav, flac 等
- 📁 代码：py, js, html, css 等
- 📁 可执行文件：exe, app, dmg 等
- 📁 其他：未分类的文件

**适用场景：**
- 整理杂乱的下载文件夹
- 清理桌面文件
- 归档项目文件
- 整理照片和文档

---

### 2. 文件批量重命名工具 (`batch_rename.py`)

一个功能强大的文件批量重命名工具，支持多种重命名模式。

**主要功能：**
- ✅ 四种重命名模式：添加前缀、添加后缀、替换文本、序号命名
- ✅ 实时预览重命名效果
- ✅ 智能处理文件名冲突
- ✅ 支持批量处理大量文件
- ✅ 详细的错误报告

**使用方法：**
```bash
python3 batch_rename.py
```

**重命名模式：**

1. **添加前缀**：在原文件名前添加指定文本
   - 例：`photo.jpg` → `vacation_photo.jpg`

2. **添加后缀**：在原文件名后（扩展名前）添加指定文本
   - 例：`report.pdf` → `report_final.pdf`

3. **替换文本**：查找并替换文件名中的指定文本
   - 例：`old_name.txt` → `new_name.txt`

4. **序号命名**：使用前缀+序号的方式重命名
   - 例：`IMG001.jpg`, `IMG002.jpg`, `IMG003.jpg`
   - 支持自定义起始序号
   - 自动补零对齐

**操作步骤：**
1. 运行程序，弹出图形界面
2. 点击"选择文件夹"选择包含文件的文件夹
3. 选择重命名模式
4. 输入相应的参数（前缀、后缀、替换文本等）
5. 查看预览效果
6. 点击"开始重命名"执行批量重命名

**适用场景：**
- 批量重命名照片
- 整理下载的文件
- 统一文件命名格式
- 为文件添加标识

---

### 4. 学生管理系统 (`student_manager.py`)

一个简易但功能完整的学生信息管理系统，支持学生信息的增删改查和导出。

**主要功能：**
- ✅ 学生信息录入（学号、姓名、性别、年龄、班级、联系电话、备注）
- ✅ 学生信息展示（表格形式，清晰直观）
- ✅ 修改学生信息
- ✅ 删除学生信息
- ✅ 导出为Excel（CSV格式，Excel可直接打开）
- ✅ 数据持久化（自动保存到本地JSON文件）
- ✅ 数据验证（学号唯一性、年龄合理性检查）

**使用方法：**
```bash
python3 student_manager.py
```

**操作步骤：**

1. **添加学生**：
   - 在左侧表单中填写学生信息
   - 学号和姓名为必填项
   - 点击"添加学生"按钮

2. **修改学生**：
   - 在右侧表格中选中要修改的学生
   - 点击"修改"按钮
   - 信息会自动填充到左侧表单
   - 修改后点击"添加学生"保存

3. **删除学生**：
   - 在右侧表格中选中要删除的学生
   - 点击"删除选中"按钮
   - 确认后即可删除

4. **导出Excel**：
   - 点击"导出Excel"按钮
   - 自动生成CSV文件（可用Excel打开）
   - 文件名格式：`学生信息表_20251022_164830.csv`

**功能特点：**
- 📊 实时统计学生人数
- 💾 数据自动保存，下次打开自动加载
- 🔍 表格支持横向和纵向滚动
- ✏️ 学号唯一性检查，防止重复
- 📝 支持备注信息，记录额外内容
- 📱 联系电话记录，方便沟通

**适用场景：**
- 班级学生信息管理
- 培训班学员管理
- 社团成员管理
- 小型教育机构使用

**数据说明：**
- 数据保存在：`students_data.json`
- 导出文件为CSV格式，使用UTF-8编码
- Excel可直接打开CSV文件进行进一步编辑

---

### 3. Word文档合并工具 (`merge_documents.py`)

一个基于Tkinter开发的图形化Word文档合并工具，可以将多个docx文件合并为一个文件。

**主要功能：**
- ✅ 图形化界面，操作简单直观
- ✅ 支持选择文件夹批量处理
- ✅ 自动检测并合并所有.docx文件
- ✅ 严格格式检查，只处理docx格式
- ✅ 保留原文档的段落和表格样式
- ✅ 合并完成后可直接打开文件位置

**使用方法：**
```bash
python3 merge_documents.py
```

**操作步骤：**
1. 运行程序，弹出图形界面
2. 点击"选择文件夹"按钮
3. 选择包含docx文件的文件夹
4. 点击"开始合并"按钮
5. 合并完成后会在原文件夹生成 `merged.docx`

**注意事项：**
- 文件夹中只能包含.docx格式的文件
- 如果存在其他格式文件，会提示错误并要求重新选择
- 合并时会保持文件的原始顺序（按文件名排序）

## 🛠️ 环境要求

- Python 3.7+
- pip (Python包管理器)

## 📦 依赖安装

### 文件分类整理工具
无需额外依赖，使用Python标准库即可运行。

### 文件批量重命名工具
无需额外依赖，使用Python标准库即可运行。

### 学生管理系统
无需额外依赖，使用Python标准库即可运行。

### Word文档合并工具
```bash
pip3 install python-docx
```

## 🚀 快速开始

1. 克隆仓库
```bash
git clone <repository-url>
cd python_tools
```

2. 安装依赖
```bash
pip3 install -r requirements.txt
```

3. 运行工具
```bash
python3 <tool_name>.py
```

## 📝 开发计划

未来将持续添加更多实用的自动化工具，包括但不限于：
- [x] 文件分类整理工具 ✅
- [x] 文件批量重命名工具 ✅
- [x] Word文档合并工具 ✅
- [x] 学生管理系统 ✅
- [ ] PDF文件批量处理工具（合并、拆分、转换）
- [ ] Excel数据自动化处理
- [ ] 图片批量压缩和格式转换
- [ ] 文本文件批量处理
- [ ] 二维码批量生成工具

## 🤝 贡献

欢迎提交Issue和Pull Request来帮助改进这些工具！

## 📄 许可证

本项目采用 MIT 许可证。

## 📧 联系方式

如有问题或建议，欢迎通过Issue进行反馈。

---

**⭐ 如果这个项目对你有帮助，欢迎Star支持！**