# windows-file-renaming-toolkit

**Repository Path**: MagicBude/windows-file-renaming-toolkit

## Basic Information

- **Project Name**: windows-file-renaming-toolkit
- **Description**: Windows 文件批量重命名工具箱 - 批处理脚本 + Python GUI 工具 + 详细中文文档

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-22
- **Last Updated**: 2026-01-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Windows, rename

## README

# Windows 文件批量重命名工具箱

<div align="center">

![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Platform](https://img.shields.io/badge/platform-Windows-lightgrey.svg)
![Language](https://img.shields.io/badge/language-Python%20%7C%20Batch-green.svg)

**专注于 Windows 文件批量重命名的实用工具集**

[功能特性](#功能特性) • [快速开始](#快速开始) • [使用文档](#使用文档) • [贡献指南](#贡献指南)

</div>

---

## 📋 项目简介

本项目提供了一套完整的 Windows 文件批量重命名解决方案，包含：

- 🔧 **13 个批处理脚本** - 覆盖常见重命名场景，双击即用
- 🖥️ **图形界面工具** - Python 开发的 GUI 程序，功能强大
- 📖 **详细中文文档** - 从入门到精通，配有示例说明

**适用人群：** 需要批量处理文件名的所有用户，无需编程基础

---

## ✨ 功能特性

### 批处理脚本（.bat）

| 脚本 | 功能 | 示例 |
|------|------|------|
| 1-文件名添加后缀 | 在文件名后添加后缀 | `report.docx` → `report_backup.docx` |
| 2-文件名添加前缀 | 在文件名前添加前缀 | `report.docx` → `2026_report.docx` |
| 3-添加新扩展名 | 添加新的扩展名 | `report.docx` → `report.docx.backup` |
| 4-删除指定扩展名 | 删除指定扩展名 | `report.docx.backup` → `report.docx` |
| 5-替换扩展名 | 替换文件扩展名 | `archive.7z` → `archive.rar` |
| 6-替换文件名中的文字 | 批量替换文字 | `旧项目_报告.docx` → `新项目_报告.docx` |
| 7-特定类型文件添加后缀 | 只处理指定类型 | 只给 `.docx` 文件添加后缀 |
| 8-删除文件名中的后缀 | 删除文件名后缀 | `report_backup.docx` → `report.docx` |
| 9-按日期添加前缀 | 自动添加日期前缀 | `report.docx` → `20260122_report.docx` |
| 10-按文件类型分类 | 按类型整理文件 | `photo.jpg` → `图片/photo.jpg` |
| 11-转换为小写 | 文件名转小写 | `Report.DOCX` → `report.docx` |
| 12-转换为大写 | 文件名转大写 | `report.docx` → `REPORT.DOCX` |
| 13-删除空格 | 删除文件名空格 | `my report.docx` → `myreport.docx` |

### 图形界面工具（Python GUI）

- ✅ **实时预览** - 执行前预览重命名效果
- ✅ **文件过滤** - 按文件类型筛选
- ✅ **冲突检测** - 自动检测文件名冲突
- ✅ **多种操作** - 支持 11 种重命名操作
- ✅ **序号重命名** - 批量添加序号
- ✅ **预设管理** - 保存/加载常用配置
- ✅ **格式转换** - 转换大小写、删除空格（v1.2.0 新增）
- ✅ **安全机制** - 执行前需确认，防止误操作

---

## 🚀 快速开始

### 使用批处理脚本

1. **下载项目**
   ```bash
   git clone https://gitee.com/MagicBude/windows-file-renaming-toolkit.git
   ```

2. **选择脚本**
   - 进入 `批处理脚本/` 文件夹
   - 选择需要的脚本（如 `1-文件名添加后缀.txt`）

3. **修改参数**
   - 用记事本打开脚本
   - 根据注释修改参数（如后缀内容）

4. **转换为批处理**
   - 将文件扩展名从 `.txt` 改为 `.bat`

5. **执行重命名**
   - 将 `.bat` 文件放到目标文件夹
   - 双击运行

### 使用图形界面工具

**方法一：直接运行（需要 Python）**

1. 确保已安装 Python 3.6+
2. 双击 `运行.bat` 启动工具

**方法二：使用 EXE 版本（无需 Python）**

1. 下载 [Releases](https://gitee.com/MagicBude/windows-file-renaming-toolkit/releases) 中的 exe 文件
2. 双击运行即可

**方法三：自己打包成 EXE**

1. 双击 `打包成exe.bat`
2. 等待打包完成
3. 在 `dist/` 文件夹获取 exe 文件

---

## 📖 使用文档

### 批处理脚本

详细说明请查看：[Windows批处理常用命令.md](./Windows批处理常用命令.md)

包含：
- 概念说明（文件名、扩展名、后缀、前缀）
- 每个脚本的详细用法
- 变量说明
- 实用技巧
- 注意事项

### 图形界面工具

详细说明请查看：[使用说明.md](./使用说明.md)

包含：
- 功能介绍
- 使用步骤
- 使用示例
- 常见问题
- 打包说明

---

## 📂 项目结构

```
windows-file-renaming-toolkit/
├── 批处理脚本/
│   ├── 1-文件名添加后缀.txt
│   ├── 2-文件名添加前缀.txt
│   ├── 3-添加新扩展名.txt
│   ├── 4-删除指定扩展名.txt
│   ├── 5-替换扩展名.txt
│   ├── 6-替换文件名中的文字.txt
│   ├── 7-特定类型文件添加后缀.txt
│   ├── 8-删除文件名中的后缀.txt
│   ├── 9-按日期添加前缀.txt
│   ├── 10-按文件类型分类.txt
│   ├── 11-转换为小写.txt
│   ├── 12-转换为大写.txt
│   └── 13-删除空格.txt
├── GUI工具/
│   ├── 批量重命名工具.py
│   ├── 运行.bat
│   ├── 打包成exe.bat
│   └── 使用说明.md
├── 文档/
│   ├── Windows批处理常用命令.md
│   ├── 打包说明.md
│   └── 手动打包步骤.txt
├── README.md
├── CHANGELOG.md
└── LICENSE
```

---

## 💡 使用示例

### 示例 1：批量添加日期前缀

**场景：** 给所有照片添加日期前缀

**使用脚本：** `2-文件名添加前缀.txt`

**步骤：**
1. 打开脚本，修改前缀为 `2024-01-22_`
2. 保存为 `.bat` 文件
3. 放到照片文件夹，双击运行

**效果：**
- `photo1.jpg` → `2024-01-22_photo1.jpg`
- `photo2.jpg` → `2024-01-22_photo2.jpg`

### 示例 2：批量修改文件扩展名

**场景：** 将所有 txt 文件改为 md 文件

**使用脚本：** `5-替换扩展名.txt`

**步骤：**
1. 打开脚本，设置原扩展名 `txt`，新扩展名 `md`
2. 保存为 `.bat` 文件
3. 放到目标文件夹，双击运行

**效果：**
- `readme.txt` → `readme.md`
- `notes.txt` → `notes.md`

### 示例 3：使用 GUI 工具序号重命名

**场景：** 将杂乱的文件名统一为序号格式

**步骤：**
1. 启动图形界面工具
2. 选择文件夹
3. 选择"使用序号重命名"
4. 设置前缀、起始序号、位数
5. 预览效果
6. 执行重命名

**效果：**
- `IMG_1234.jpg` → `照片001.jpg`
- `DSC_5678.jpg` → `照片002.jpg`

---

## ⚠️ 注意事项

- ⚠️ **重命名操作不可撤销**，建议先备份重要文件
- ⚠️ **执行前务必预览效果**，确认无误后再执行
- ⚠️ **注意文件名冲突**，避免覆盖现有文件
- ⚠️ **在测试文件夹中验证**，确认效果后再正式使用

---

## 🤝 贡献指南

欢迎贡献代码、报告问题或提出建议！

### 如何贡献

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request

### 贡献方向

- 🐛 报告 Bug
- 💡 提出新功能建议
- 📝 改进文档
- 🔧 添加新的批处理脚本
- 🎨 改进 GUI 界面
- 🌍 添加多语言支持

---

## 📜 开源协议

本项目采用 [MIT License](./LICENSE) 开源协议

- ✅ 可以自由使用、修改、分发
- ✅ 可以用于商业用途
- ✅ 需要保留版权声明

---

## 🔗 相关链接

- [Gitee 仓库](https://gitee.com/MagicBude/windows-file-renaming-toolkit)
- [问题反馈](https://gitee.com/MagicBude/windows-file-renaming-toolkit/issues)
- [更新日志](./CHANGELOG.md)

---

## 📊 Star 历史

如果这个项目对你有帮助，请给个 ⭐ Star 支持一下！

---

## 📮 联系方式

如有问题或建议，欢迎通过以下方式联系：

- 提交 [Issue](https://gitee.com/MagicBude/windows-file-renaming-toolkit/issues)
- 发起 [Pull Request](https://gitee.com/MagicBude/windows-file-renaming-toolkit/pulls)

---

<div align="center">

**感谢使用 Windows 文件批量重命名工具箱！**

Made with ❤️ by [MagicBude](https://gitee.com/MagicBude)

</div>