用Python实现文件批量重命名：适合新手的自动化小案例

批量重命名文件是日常办公与项目整理中最常见的重复劳动之一。当文件夹中堆积了数十张相机导出的原始照片、下载的报表或整理好的文档时，逐个手动右键重命名不仅耗时，还极易出现序号遗漏或命名格式不统一的情况。利用 Python 自动化处理这一需求，是初学者理解“代码如何解决具体现实问题”的理想切入点。

核心解决路径仅需三个步骤：定位目标文件夹中的文件列表、按照统一规则拼接新文件名，以及调用文件系统操作完成重命名。Python 内置的 pathlib 模块为我们提供了面向对象且跨平台的文件处理接口，无需安装任何第三方库，即可在保护原有文件扩展名的前提下，安全、高效地完成整个转换流程。

一、为什么推荐新手使用 pathlib 模块？

在较旧的 Python 教程中，批量重命名通常使用 os.listdir、os.path.join 和 os.rename 组合。虽然这种方式依然有效，但需要频繁进行字符串拼接与路径分隔符处理，初学者很容易因为 Windows 系统的反斜杠 \ 和 macOS/Linux 系统的正斜杠 / 混淆而报错。

从 Python 3.4 开始引入的内置模块 pathlib，将文件路径抽象为对象。使用 pathlib.Path 处理文件重命名，具备三大显著优势：

• 结构自动解构：对象自带 .stem（主文件名，不含扩展名）和 .suffix（扩展名，含有点号），避免了手动使用 str.split() 截取后缀时可能引发的错误；
• 跨平台统一性：无论是 Windows 还是类 Unix 系统，路径拼接与跳转均通过面向对象方法完成，无需手动拼接路径分隔符；
• 语法直观：重命名操作直接作为路径对象的方法调用，例如 file_path.rename(new_path)，逻辑连贯且易读。

二、具体应用场景与目标设定

假定我们有一个名为 photos 的文件夹，里面存放了相机拍摄的照片。由于设备默认的命名格式杂乱（如 IMG_0083.JPG、IMG_0084.JPG 等），我们希望将其统一重命名为以具体事件和规范序号命名的格式：

• 旧文件示例：IMG_0083.JPG、IMG_0084.JPG
• 目标规范：Travel_2024_001.jpg、Travel_2024_002.jpg

为了保证文件在文件管理器中按名称升序排列时顺序正确，必须对序号使用固定位数补零（例如 001、002，而不是 1、2，否则在排序时 10 会排在 2 前面）。

三、完整实操代码与逐行解析

下面是一个包含安全预演功能的完整 Python 脚本。请在与目标文件夹同级目录下新建一个 batch_rename.py 文件并粘贴以下代码：

from pathlib import Path

def batch_rename_files(folder_path: str, prefix: str, extension: str = "*.jpg", dry_run: bool = True):
    """
    批量重命名指定目录下的文件
    :param folder_path: 目标文件夹路径
    :param prefix: 重命名后的前缀名称
    :param extension: 匹配的文件通配模式，默认为 *.jpg
    :param dry_run: 是否为预演模式。若为 True 则只打印预览，不实际修改磁盘
    """
    target_dir = Path(folder_path)

    # 1. 验证目标路径是否真实存在且为目录
    if not target_dir.exists() or not target_dir.is_dir():
        print(f"错误：指定路径 '{folder_path}' 不存在或不是有效目录。")
        return

    # 2. 获取符合扩展名条件的所有文件列表，并按名称排序
    files = sorted([f for f in target_dir.glob(extension) if f.is_file()])
    total_files = len(files)

    if total_files == 0:
        print(f"提示：在 '{folder_path}' 中未找到匹配 '{extension}' 的文件。")
        return

    print(f"共发现 {total_files} 个待处理文件。当前模式：{'【预演模式（Dry-Run）】' if dry_run else '【正式执行模式】'}")
    print("-" * 60)

    # 3. 循环遍历并构造新名称
    for index, old_file in enumerate(files, start=1):
        # 序号补零：:03d 表示至少保留 3 位宽度，不足补 0
        new_name = f"{prefix}_{index:03d}{old_file.suffix.lower()}"
        new_file_path = target_dir / new_name

        if dry_run:
            print(f"[预演预览] {old_file.name}  ->  {new_name}")
        else:
            # 安全防护：避免新文件名已存在造成覆盖
            if new_file_path.exists():
                print(f"[跳过] 目标文件已存在，防止覆盖：{new_name}")
                continue
            
            # 正式重命名
            old_file.rename(new_file_path)
            print(f"[成功修改] {old_file.name}  ->  {new_name}")

    print("-" * 60)
    if dry_run:
        print("预演结束。确认以上映射无误后，将 dry_run 设置为 False 即可正式生效。")
    else:
        print("所有文件批量重命名执行完成。")

if __name__ == "__main__":
    # 配置参数
    TARGET_FOLDER = "./photos"
    NEW_PREFIX = "Travel_2024"
    FILE_PATTERN = "*.[jJ][pP][gG]"  # 匹配大小写 jpg/JPG

    # 首次执行推荐保持 dry_run=True 进行预演
    batch_rename_files(
        folder_path=TARGET_FOLDER,
        prefix=NEW_PREFIX,
        extension=FILE_PATTERN,
        dry_run=True
    )

在上述代码中，核心技术点如下：

1. target_dir.glob(extension)：高效遍历目标目录，仅筛选出符合要求的文件对象，忽略无关的文件夹与隐藏文件；
2. enumerate(files, start=1)：内置枚举函数，自动为文件按顺序分配从 1 开始的计数器，避免手动维护计数变量；
3. old_file.suffix.lower()：将原有扩展名统一转换为小写（如 .JPG 转为 .jpg），规范文件系统格式；
4. target_dir / new_name：这是 pathlib 独特的路径拼接语法，斜杠运算符直接实现路径结合，简洁且跨系统兼容。

四、安全第一：为什么必须引入 Dry-Run 预演机制？

新手编写文件处理程序时最容易犯的错误是直接调用 rename。一旦字符串拼接逻辑有误（例如写成了固定文件名没有加序号，或者扩展名拼接丢失），脚本会在毫秒级内将整个文件夹的文件改写为同名文件并造成数据覆盖丢失，且操作系统无法通过回收站一键撤销。

Dry-Run（空运行/预演）是工业级自动化脚本的标准实践。在执行写入、删除或重命名操作前，先通过控制台将每一个“旧文件 -> 新文件”的映射关系清晰打印出来。只有当我们在终端肉眼核对确认无误后，再开启正式修改开关。

终端预演运行示例输出

在首次将 dry_run=True 运行时，终端输出内容如下：

共发现 3 个待处理文件。当前模式：【预演模式（Dry-Run）】
------------------------------------------------------------
[预演预览] IMG_0083.JPG  ->  Travel_2024_001.jpg
[预演预览] IMG_0084.JPG  ->  Travel_2024_002.jpg
[预演预览] IMG_0085.JPG  ->  Travel_2024_003.jpg
------------------------------------------------------------
预演结束。确认以上映射无误后，将 dry_run 设置为 False 即可正式生效。

五、新手容易遇到的常见问题与避坑指南

1. 目标文件已存在报错（FileExistsError）：
   在 Windows 环境下，若尝试将文件重命名为一个当前目录下已存在的文件名，Python 会抛出 FileExistsError。而在某些 Unix 系统下，rename 可能会无提示地覆盖原有同名文件。因此，在调用 rename 前通过 if new_file_path.exists(): continue 进行前置拦截至关重要。
2. 文件被占用导致无权限（PermissionError）：
   如果某个文件正在被图像查看器、文档编辑器或播放器打开，操作系统会锁定该文件，重命名时将触发 PermissionError: [WinError 32] 另一个程序正在使用此文件。执行脚本前请确保相关文件已全部关闭。
3. 为什么序号补零必须留够位数？
   如果总文件数超过 100 张，使用 :02d 格式化到第 100 张时会变成 100，造成排序错乱。建议根据文件总量预留宽度，通常百张级别使用 :03d（如 001、099、100），千张级别使用 :04d。
4. 切勿在遍历的同时生成符合通配符的新文件：
   如果遍历条件为 *.jpg，且重命名后的文件扩展名同样也是 .jpg，若直接使用生成器迭代，可能会在部分操作系统中引发“重命名后的文件被二次重复遍历并再次改名”的死循环。先通过列表推导式 files = sorted([...]) 一次性读取静态快照，即可彻底消除此隐患。

结语

批量重命名作为 Python 自动化的基础场景，不仅展示了标准库 pathlib 在路径解析与文件管理方面的优雅性，更展现了编程解决日常重复性工作的效率提升。掌握“分析路径结构、组装新规范、安全预演、异常防范”这套标准方法后，读者还可以将其灵活扩展到更多复杂场景，例如根据文件的创建日期重命名、根据特定关键字过滤替换，或者跨多级子文件夹递归整理各类文件资产。