手把手教你写一个 Python 批量重命名工具：从0到1实战教程

引言：为什么需要批量重命名工具？

在日常生活和工作中，我们经常需要处理大量文件：手机拍摄的照片、下载的电子书、项目文档等。当文件数量达到几十甚至上百个时，手动修改文件名不仅效率低下，还容易出错。例如：

• 照片命名混乱（IMG_001.jpg, IMG_002.jpg...）

• 文档版本管理（report_v1.docx, report_v2.docx...）

• 下载文件包含乱码（电影名称包含广告字符）

本文将带你从零开始开发一个功能完整的Python批量重命名工具，涵盖以下核心功能：

1. 批量添加前缀/后缀

2. 序列号自动编号

3. 查找替换文件名中的特定字符

4. 文件扩展名批量修改

5. 大小写转换

6. 实时预览更改效果

一、开发环境准备

1.1 基础工具安装

确保已安装Python 3.6+，可通过以下命令验证：

python --version
# 或
python3 --version

1.2 推荐开发工具

1.3 创建项目结构

file_renamer/
├── main.py      # 主程序入口
├── renamer_core.py  # 核心功能实现
├── ui_elements.py   # 用户界面组件（可选）
└── test_files/    # 测试用文件目录

二、核心功能实现

2.1 文件遍历基础

import os

def get_files(directory):
  """获取目录下所有文件（不含子目录）"""
  return [f for f in os.listdir(directory) 
      if os.path.isfile(os.path.join(directory, f))]

# 示例用法
files = get_files('./test_files')
print(f"找到 {len(files)} 个文件")

2.2 核心重命名函数

def rename_file(old_path, new_name, keep_extension=True):
  """
  重命名单个文件
  :param old_path: 原始路径
  :param new_name: 新文件名（不含扩展名）
  :param keep_extension: 是否保留原扩展名
  :return: 新完整路径或错误信息
  """
  try:
    dir_path = os.path.dirname(old_path)
    if keep_extension:
      ext = os.path.splitext(old_path)[1]
      new_path = os.path.join(dir_path, f"{new_name}{ext}")
    else:
      new_path = os.path.join(dir_path, new_name)
      
    # 处理文件名冲突
    counter = 1
    while os.path.exists(new_path):
      name_part, ext = os.path.splitext(new_name)
      new_path = os.path.join(dir_path, f"{name_part}_{counter}{ext}")
      counter += 1
      
    os.rename(old_path, new_path)
    return new_path
  except Exception as e:
    return f"Error renaming {old_path}: {str(e)}"

2.3 批量处理框架

def batch_rename(files, rename_func):
  """
  批量处理文件
  :param files: 文件列表
  :param rename_func: 重命名函数，接收(old_name, index)返回new_name
  :return: 操作结果字典
  """
  results = {
    'success': [],
    'failed': []
  }
  
  for idx, old_name in enumerate(files, 1):
    old_path = os.path.join(directory, old_name) # 需要全局directory变量
    try:
      new_name = rename_func(old_name, idx)
      result = rename_file(old_path, new_name)
      if "Error" in result:
        results['failed'].append((old_name, result))
      else:
        results['success'].append((old_name, new_name))
    except Exception as e:
      results['failed'].append((old_name, str(e)))
  
  return results

三、六大核心功能实现

3.1 添加前缀/后缀

def add_prefix_suffix(name, prefix="", suffix=""):
  """添加前缀和后缀"""
  return f"{prefix}{name}{suffix}"

# 使用示例
files = ["a.txt", "b.jpg"]
new_names = [add_prefix_suffix(f, "vacation_", "_2023") for f in files]
# 结果: ['vacation_a_2023.txt', 'vacation_b_2023.jpg']

3.2 序列号自动编号

def sequential_numbering(name, index, prefix="", suffix="", digits=3):
  """序列号编号"""
  num_str = str(index).zfill(digits)
  return f"{prefix}{num_str}{suffix}{os.path.splitext(name)[1]}"

# 使用示例
files = ["photo.jpg", "document.pdf"]
new_names = [sequential_numbering(f, i+1, "IMG_", "_edit", 4) 
       for i, f in enumerate(files)]
# 结果: ['IMG_0001_edit.jpg', 'IMG_0002_edit.pdf']

3.3 查找替换功能

def find_replace(name, old_str, new_str, all_occurrences=False):
  """字符串查找替换"""
  if all_occurrences:
    return name.replace(old_str, new_str)
  else:
    parts = name.split(old_str, 1)
    return new_str.join(parts)

# 使用示例
files = ["data_backup.csv", "project_backup.py"]
new_names = [find_replace(f, "backup", "20230801") for f in files]
# 结果: ['data_20230801.csv', 'project_20230801.py']

3.4 扩展名修改

def change_extension(name, new_ext):
  """修改文件扩展名"""
  if not new_ext.startswith('.'):
    new_ext = '.' + new_ext
  base = os.path.splitext(name)[0]
  return base + new_ext.lower()

# 使用示例
files = ["notes.txt", "readme.md"]
new_names = [change_extension(f, "bak") for f in files]
# 结果: ['notes.bak', 'readme.bak']

3.5 大小写转换

def case_conversion(name, mode='lower'):
  """
  大小写转换
  mode: 'lower', 'upper', 'title', 'camel'
  """
  if mode == 'lower':
    return name.lower()
  elif mode == 'upper':
    return name.upper()
  elif mode == 'title':
    return name.title()
  elif mode == 'camel':
    parts = name.split('_')
    return ''.join(x.title() for x in parts)
  return name

# 使用示例
files = ["hello_world.py", "SAMPLE_FILE.TXT"]
new_names = [case_conversion(f, 'camel') for f in files]
# 结果: ['HelloWorld.py', 'SampleFile.Txt']

3.6 正则表达式高级替换

import re

def regex_replace(name, pattern, replacement):
  """正则表达式替换"""
  return re.sub(pattern, replacement, name)

# 使用示例：移除所有非字母数字字符
files = ["file#1.txt", "data@2.csv"]
new_names = [regex_replace(f, r'[^a-zA-Z0-9.]', '') for f in files]
# 结果: ['file1.txt', 'data2.csv']

四、完整工具实现

4.1 命令行版本

import argparse

def main():
  parser = argparse.ArgumentParser(description='批量文件重命名工具')
  parser.add_argument('directory', help='目标目录路径')
  parser.add_argument('--prefix', help='添加前缀')
  parser.add_argument('--suffix', help='添加后缀')
  parser.add_argument('--replace', nargs=2, metavar=('OLD', 'NEW'), 
            help='字符串替换')
  parser.add_argument('--ext', help='修改扩展名')
  parser.add_argument('--lower', action='store_true', help='转为小写')
  
  args = parser.parse_args()
  files = get_files(args.directory)
  
  def rename_func(name, _):
    if args.prefix:
      name = args.prefix + name
    if args.suffix:
      name = name + args.suffix
    if args.replace:
      name = name.replace(*args.replace)
    if args.ext:
      name = change_extension(name, args.ext)
    if args.lower:
      name = name.lower()
    return name
  
  results = batch_rename(files, rename_func)
  print("\n操作结果：")
  print(f"成功: {len(results['success'])}")
  print(f"失败: {len(results['failed'])}")

if __name__ == "__main__":
  main()

4.2 GUI版本（使用Tkinter）

import tkinter as tk
from tkinter import ttk, filedialog, messagebox

class RenamerApp:
  def __init__(self, root):
    self.root = root
    self.root.title("Python批量重命名工具")
    
    # 文件选择区域
    self.dir_var = tk.StringVar()
    ttk.Label(root, text="选择目录:").pack()
    ttk.Entry(root, textvariable=self.dir_var, width=50).pack()
    ttk.Button(root, text="浏览...", command=self.browse_dir).pack()
    
    # 操作选项区域
    ttk.Label(root, text="\n重命名选项:").pack()
    
    # 前缀输入
    ttk.Label(root, text="添加前缀:").pack()
    self.prefix_entry = ttk.Entry(root)
    self.prefix_entry.pack()
    
    # 后缀输入
    ttk.Label(root, text="添加后缀:").pack()
    self.suffix_entry = ttk.Entry(root)
    self.suffix_entry.pack()
    
    # 替换选项
    ttk.Label(root, text="查找替换 (用逗号分隔):").pack()
    self.replace_entry = ttk.Entry(root)
    self.replace_entry.pack()
    
    # 执行按钮
    ttk.Button(root, text="预览更改", command=self.preview).pack(pady=10)
    ttk.Button(root, text="执行重命名", command=self.execute).pack()
    
    # 结果显示
    self.result_text = tk.Text(root, height=10, width=60)
    self.result_text.pack(pady=10)
  
  def browse_dir(self):
    directory = filedialog.askdirectory()
    if directory:
      self.dir_var.set(directory)
  
  def get_options(self):
    return {
      'prefix': self.prefix_entry.get(),
      'suffix': self.suffix_entry.get(),
      'replace': [x.strip() for x in self.replace_entry.get().split(',') 
            if x.strip()] if self.replace_entry.get() else None
    }
  
  def preview(self):
    directory = self.dir_var.get()
    if not directory:
      messagebox.showerror("错误", "请选择目录")
      return
      
    files = get_files(directory)
    options = self.get_options()
    
    preview_text = "原始名称 -> 新名称\n" + "-"*40 + "\n"
    
    def rename_func(name, _):
      new_name = name
      if options['prefix']:
        new_name = options['prefix'] + new_name
      if options['suffix']:
        new_name = new_name + options['suffix']
      if options['replace'] and len(options['replace']) == 2:
        new_name = new_name.replace(options['replace'][0], options['replace'][1])
      return new_name
    
    for old, new in [(f, rename_func(f, 0)) for f in files]:
      preview_text += f"{old} -> {new}\n"
    
    self.result_text.delete(1.0, tk.END)
    self.result_text.insert(tk.END, preview_text)
  
  def execute(self):
    directory = self.dir_var.get()
    if not directory:
      messagebox.showerror("错误", "请选择目录")
      return
      
    files = get_files(directory)
    options = self.get_options()
    
    def rename_func(name, _):
      # 同preview中的实现
      pass
    
    results = batch_rename(files, rename_func)
    
    report = f"操作完成:\n成功: {len(results['success'])}\n失败: {len(results['failed'])}\n\n失败详情:\n"
    for old, err in results['failed']:
      report += f"{old}: {err}\n"
    
    self.result_text.delete(1.0, tk.END)
    self.result_text.insert(tk.END, report)

if __name__ == "__main__":
  root = tk.Tk()
  app = RenamerApp(root)
  root.mainloop()

五、功能测试与验证

5.1 测试用例设计

5.2 边界条件测试

1. 空文件名处理：验证对""或" "等特殊输入的处理

2. 超长文件名：测试255字符限制的文件名处理

3. 特殊字符：包含/\:*?"<>|等字符的文件名

4. 权限问题：尝试重命名只读文件或无权限目录

5.3 性能测试

六、最佳实践与注意事项

6.1 安全建议

1. 始终备份文件：在执行批量操作前创建备份

2. 预览功能：实现变更预览再确认执行

3. 原子操作：使用临时文件名，成功后再替换原文件

6.2 跨平台兼容性

1. 路径分隔符：使用os.path.join()代替硬编码/或\

2. 文件名编码：处理非ASCII字符时使用utf-8编码

3. 大小写敏感：Linux系统区分大小写，Windows不区分

6.3 错误处理策略

try:
  # 文件操作代码
except FileNotFoundError:
  print("文件不存在，请检查路径")
except PermissionError:
  print("权限不足，请以管理员身份运行")
except Exception as e:
  print(f"未知错误: {str(e)}")

七、扩展功能建议

1. 子目录递归处理：添加recursive=True参数

2. EXIF信息读取：从照片EXIF中提取日期作为文件名

3. 撤销功能：记录操作日志实现撤销

4. 正则表达式验证：在GUI中添加正则表达式测试框

结语

通过本文的实战教程，你已掌握：

1. Python文件系统操作核心API

2. 批量处理文件的设计模式

3. 六大常用重命名场景的实现

4. 命令行与GUI两种交互方式

这个工具可直接用于日常文件管理，也可作为学习Python文件处理的实践项目。建议尝试添加更多自定义规则，如根据文件内容重命名、批量修改文件夹名称等高级功能。