# rename-file

**Repository Path**: lggyx/rename-file

## Basic Information

- **Project Name**: rename-file
- **Description**: 批量文件名修改工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-10
- **Last Updated**: 2025-11-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 批量文件名修改工具

这是一个功能完整的Python GUI应用程序，用于批量修改文件名，支持正则表达式匹配和多种修改规则。

## 功能特性

- ✅ **正则表达式匹配**: 使用正则表达式精确匹配目标文件名
- ✅ **多种修改规则**: 支持前缀、后缀、字符串替换、正则替换
- ✅ **安全机制**: 修改前预览确认，避免误操作
- ✅ **跨平台支持**: 自动处理不同操作系统的路径格式
- ✅ **详细日志**: 记录所有操作和错误信息
- ✅ **递归搜索**: 可选递归搜索子目录
- ✅ **错误处理**: 完善的异常处理和用户提示
- ✅ **GUI界面**: 简洁美观的图形用户界面
- ✅ **批量导出**: 支持导出修改列表
- ✅ **文件过滤**: 支持通配符和正则表达式过滤

## 界面特性

- ✅ **简洁美观**: 界面简洁美观，易于使用
- ✅ **友好提示**: 友好提示，易于理解
- ✅ **易于操作**: 操作简单，易于使用
- ✅ **易于扩展**: 易于扩展，易于维护
- ✅ **易于调试**: 易于调试，易于修复

## 快速开始

### 开发环境运行

1. **安装依赖** (使用uv):
```bash
uv sync
```

2. **运行应用程序**:
```bash
uv run python main.py
```

### 打包为可执行文件

1. **安装打包依赖**:
```bash
uv add pyinstaller
```

2. **打包应用程序**:
```bash
uv run python build.py
```

3. **生成的程序位置**:
   - 便携版: `distribution/main.exe`
   - 安装版: 运行 `distribution/install.bat`
   - 启动脚本: `distribution/启动程序.bat`

## 使用说明

### 基本使用流程

1. **选择目录**: 点击"选择目录"按钮选择要处理的文件夹
2. **设置过滤**: 设置文件过滤条件（通配符和正则表达式）
3. **扫描文件**: 点击"扫描文件"查找匹配的文件
4. **设置规则**: 选择修改规则类型并设置参数
5. **预览修改**: 点击"预览修改"查看修改效果
6. **执行修改**: 确认无误后点击"执行修改"

### 支持的修改规则

1. **前缀添加**: 在文件名前添加指定文本
2. **后缀添加**: 在文件名后（扩展名前）添加指定文本
3. **字符串替换**: 替换文件名中的指定字符串
4. **正则替换**: 使用正则表达式进行替换

### 安全特性

- **预览机制**: 所有修改都会先预览，确认无误后再执行
- **状态检查**: 自动检查文件名冲突和合法性
- **日志记录**: 所有操作都会记录到日志文件中
- **错误处理**: 完善的异常处理和用户提示

## 开发指南

### 项目结构

```
rename-file/
├── main.py              # 主程序文件
├── build.py             # 打包脚本
├── pyproject.toml       # 项目配置和依赖
├── README.md            # 项目说明文档
└── .python-version      # Python版本配置
```

### 依赖管理

项目使用 `uv` 进行依赖管理：

```bash
# 安装依赖
uv sync

# 添加新依赖
uv add package_name

# 运行程序
uv run python main.py
```

### 打包说明

使用 `PyInstaller` 打包为独立可执行文件：

```bash
# 打包应用程序
uv run python build.py
```

打包后的程序包含：
- 主程序文件 (`main.exe`)
- 便携版启动脚本
- 安装程序脚本
- 说明文档

## 技术栈

- **GUI框架**: wxPython
- **打包工具**: PyInstaller
- **依赖管理**: uv
- **日志系统**: Python logging
- **文件操作**: pathlib, os
- **正则表达式**: re

## 注意事项

1. **备份重要文件**: 在执行批量修改前，请务必备份重要文件
2. **管理员权限**: 安装程序需要管理员权限
3. **文件名冲突**: 程序会自动检测文件名冲突
4. **非法字符**: 程序会检查文件名合法性
5. **日志文件**: 操作日志保存在 `logs/` 目录下

## 许可证

本项目采用 MIT 许可证。

## 贡献

欢迎提交 Issue 和 Pull Request 来改进这个工具。