在日常的文件管理工作中，批量重命名文件常常是提高工作效率的关键之一。本文围绕 Python批量重命名文件，从入门到实战，系统分享实用方法，帮助你快速上手并应对不同场景。
一、为什么要学习批量重命名文件
1.1 基础概念与需求场景
在日常工作或个人项目中，大量文件的命名不规范会带来检索困难与版本混乱。掌握批量重命名的技术，可以让你的文件夹结构更清晰、搜索效率更高、版本依赖更可控。通过自动化处理，可以实现统一前缀/后缀、统一编号、统一日期格式等目标，避免人工逐个改名的重复劳动。
对于你来说，理解目录遍历、筛选条件和重命名策略是第一步。掌握这些要点后，下一步将进入代码实现与实际场景应用。
1.2 在日常工作中的应用场景
媒体整理、代码仓库的版本化备份、实验数据的统一标注等，都需要对大量文件进行重命名。通过 Python 实现，能够实现<可重复性、快速迭代和错误回滚等优势，使得工作流程更加稳定。
你还可以将重命名流程与其他自动化流程结合，如在单次执行中完成备份、日志记录以及异常告警，从而实现一个更完备的工作流。
二、从入门到实战的路线图
2.1 入门：了解 os 与 glob 模块
熟悉
os与glob模块是入门的关键。它们提供了跨平台的目录遍历、文件筛选和路径操作能力，使你可以安全地定位目标文件并对其进行修改。
核心要点：遍历目标目录、筛选指定类型的文件、获取文件扩展名、拼接新文件名。
2.2 进阶：使用正则表达式重命名
当需要对复杂命名规则进行重构时，正则表达式成为有力工具。它可以帮助你提取关键信息（如日期、序号、版本号），并据此生成新的命名模板。
重要能力：正则匹配、分组提取、模板替换、以及对不符合规则的文件进行保留或单独处理。
2.3 实战：处理大量文件与回滚机制
实际场景中，批量处理大量文件时需要考虑性能、错误处理与回滚。实现一个简单的“先备份再重命名”的流程，可以在出现问题时快速恢复原状。
还要关注日志记录与异常处理，确保每一次重命名都有痕迹可追溯，并能在必要时回滚到上一状态。
三、核心技术与实现要点
3.1 路径遍历与筛选
实现稳定的批量重命名，首要任务是准确定位目标文件。通过 os、pathlib 等方法，可以实现跨平台的文件系统操作，并结合 glob 或 rglob 按模式筛选。
在代码中，排序遍历通常有助于保持命名的一致性，避免因为随机顺序导致的混乱。
3.2 重命名策略与备份
重命名策略要根据实际需求设计，例如统一前缀、统一数字编号、按日期排序等。先备份再重命名是实战中的最佳实践之一，能在出现错误时快速恢复。
常见策略示例：将文件名改为 前缀+序号+原扩展名，或者用 日期+描述+序号 的方式命名，以增强可读性。
3.3 错误处理与日志记录
在批量操作中，错误处理不可忽视。需要捕获权限、文件锁定、命名冲突等异常，并记录到日志中，方便排查与回滚。
日志记录应包含 原始路径、目标路径、时间戳、异常信息，以确保每一步可追溯。
四、常用示例代码与实现
4.1 简单批量重命名
下面的示例演示如何将某目录下的所有文本文件重命名为 file_001.txt、file_002.txt 的格式，保留原扩展名。
from pathlib import Pathdef simple_batch_rename(directory, prefix="file_"):p = Path(directory)files = sorted([f for f in p.glob("*.txt") if f.is_file()])for idx, f in enumerate(files, 1):new_name = f"{prefix}{idx:03d}{f.suffix}"f.rename(f.with_name(new_name))# 使用示例
# simple_batch_rename("/path/to/your/folder")
核心要点：使用 Path 的 glob 进行筛选，利用 序号格式化确保命名的一致性。
4.2 依据前缀/后缀批量重命名
当你需要在原有文件名基础上添加前缀或后缀时，可结合 扩展名保护，避免更改文件类型。
from pathlib import Pathdef add_prefix_suffix(directory, prefix="", suffix=""):p = Path(directory)for f in sorted(p.iterdir()):if not f.is_file():continuenew_name = f"{prefix}{f.stem}{suffix}{f.suffix}"f.rename(f.with_name(new_name))# 使用示例
# add_prefix_suffix("/path/to/your/folder", prefix="IMG_", suffix="_2025")
扩展名保护确保文件类型不被误改，避免无法打开的问题。
4.3 按数字序列重命名与排序
当你需要对一组文件按数字序列命名并保持排序的一致性时，下面的做法很实用。
from pathlib import Pathdef rename_with_index(directory, extension=""):p = Path(directory)files = sorted([f for f in p.glob(f"*{extension}") if f.is_file()])for i, f in enumerate(files, 1):new_name = f"doc_{i:04d}{f.suffix}"f.rename(f.with_name(new_name))# 使用示例
# rename_with_index("/path/to/your/folder", ".md")
排序结果确保同一批文件在后续处理中的顺序一致，便于版本管理与比对。
4.4 使用正则表达式重命名文件
对于复杂的命名规则，正则表达式提供灵活的提取与重组能力。下面示例演示如何把日期从文件名中提取并重命名为新的模板。
import re
from pathlib import Pathdef regex_rename(directory):date_pattern = re.compile(r'(\\d{4})(\\d{2})(\\d{2})') # 例：20250130p = Path(directory)for f in sorted(p.glob("*")):if not f.is_file():continuem = date_pattern.search(f.stem)if m:y, mth, d = m.groups()new_stem = f"{y}-{mth}-{d}_{f.stem}"f.rename(f.with_name(new_stem + f.suffix))# 使用示例
# regex_rename("/path/to/your/folder")
匹配失败的文件应有明确的处理策略，例如跳过或单独记录，避免影响整批重命名。
五、常见问题与注意事项
5.1 处理不同文件夹结构
在多层目录结构中，需要明确目标层级，避免误操作。可以先对顶层目录进行测试，再逐步扩展到子目录。
若要跨多层操作，优先考虑使用 递归遍历，并对每一级别的文件名应用独立策略，以防冲突。
5.2 跨平台兼容性
Python 的 pathlib 能提供跨平台的路径处理能力，减少在 Windows、Linux、Mac 间的差异。避免使用硬编码分隔符，优先依赖 Path 的方法。
另外，文件权限与文件锁定在不同系统上表现不同，捕获权限错误并给出明确的回滚路径，是稳健实现的关键。
