如何用Python批量重命名文件并保留扩展名
文件数量一多,手动修改名称就容易出现遗漏、重复和扩展名丢失等问题。Python自带的文件处理模块能够读取目录内容,按照统一规则批量修改文件名,适合整理照片、文档、下载资料和项目素材。
批量重命名文件的关键,不是简单地给所有文件加上前缀,而是准确区分主文件名与扩展名。例如,将report.docx改成2024_report.docx时,只改变文件名部分,不能误删.docx。使用pathlib可以让这项工作更加清晰、安全。
在归档网页下载内容或其他数字资料时,可以先参考资料整理中的分类思路,再根据文件类型设计命名规则。实际执行脚本前,应先备份文件,并优先采用预览模式检查结果。
准备Python运行环境
如果电脑已经安装Python 3,就可以直接使用标准库完成任务,不需要额外安装第三方包。建议使用Python 3.8或更高版本,因为pathlib、字符串处理和文件操作接口都比较稳定。
新建一个名为rename_files.py的文件,把脚本放在待处理文件夹之外,或者通过变量指定目标目录。Windows路径可以写成原始字符串,例如r"D:\照片";Linux和macOS则通常使用"/home/user/photos"这样的路径。
from pathlib import Path
folder = Path(r"D:\待整理文件")
如果脚本与目标目录位于同一位置,也可以使用Path(".")表示当前目录。运行前应确认路径确实存在,避免因为拼写错误导致程序处理了错误的位置。
读取文件并识别扩展名
Path.iterdir()能够遍历目录中的项目,is_file()可以过滤掉子文件夹。文件的完整名称由path.name提供,去除扩展名后的部分由path.stem提供,而扩展名则由path.suffix返回。
例如,holiday.photo.jpg的stem通常是holiday.photo,suffix是.jpg。这比直接使用split(".")更可靠,因为文件名本身可能包含多个点。需要处理多重扩展名时,可以使用Path.suffixes获取扩展名列表。
for path in folder.iterdir():
if path.is_file():
print(path.name, path.stem, path.suffix)
这里的扩展名会保留原始大小写。如果希望统一成小写,可以对后缀调用.lower(),但重命名时应确认目标系统和软件对扩展名大小写没有特殊要求。
编写保留后缀的重命名脚本
最常见的规则是添加统一前缀,同时保留原扩展名。新名称可以通过path.with_name()生成,也可以使用folder / new_name拼接出新的路径。关键是把新主文件名和原来的suffix分开处理。
from pathlib import Path
folder = Path(r"D:\待整理文件")
prefix = "项目资料_"
for path in folder.iterdir():
if not path.is_file():
continue
new_name = f"{prefix}{path.stem}{path.suffix}"
new_path = path.with_name(new_name)
path.rename(new_path)
如果原文件是会议记录.pdf,执行后会变成项目资料_会议记录.pdf。对于没有扩展名的文件,path.suffix为空字符串,程序仍然可以正常生成新名称。
需要注意的是,脚本会处理目标目录中的所有文件。如果只想修改图片,可以增加后缀筛选,例如if path.suffix.lower() not in {".jpg", ".png"}: continue,从源头限制处理范围。
使用序号建立统一命名
按照序号重命名时,必须先确定排序规则,否则不同操作系统或不同运行时间可能产生不同结果。可以使用sorted()按照文件名排序,也可以按照文件创建时间或修改时间排序。
files = sorted(
[p for p in folder.iterdir() if p.is_file()],
key=lambda p: p.name.lower()
)
for index, path in enumerate(files, start=1):
new_name = f"照片_{index:03d}{path.suffix.lower()}"
path.rename(path.with_name(new_name))
{index:03d}会把数字格式化为三位数,例如001、002和010,这样文件管理器中的排列顺序更加整齐。使用path.suffix.lower()可以统一生成小写扩展名,但这会改变后缀的大小写表现。
如果文件名中含有中文、数字和英文混合内容,排序结果可能与人工直觉不同。重要资料最好先输出排序后的列表,确认顺序符合预期后再执行实际改名。
防止重名覆盖和循环改名
批量处理最需要防范的是目标名称已经存在。如果直接调用rename(),可能覆盖同名文件,也可能在某些系统中抛出异常。执行改名之前,应通过new_path.exists()检查目标路径。
if new_path.exists() and new_path != path:
print(f"跳过重名文件:{new_path.name}")
continue
path.rename(new_path)
当名称规则可能产生重复时,可以自动追加序号。更稳妥的做法是先把原文件改成临时名称,再统一改成最终名称,避免a.txt改成b.txt、而b.txt又要改成c.txt时发生冲突。
临时名称可以加入随机字符串或固定标记,例如先生成.__temp__原文件名。不过对于普通的前缀、序号和日期重命名,只要检查目标路径并保留备份,通常已经能够满足日常使用。
先预览结果再实际执行
为了降低误操作风险,可以增加一个dry_run变量。预览模式只打印原文件名和新文件名,不执行rename();确认结果无误后,再把变量改为False。
dry_run = True
for path in files:
new_name = f"照片_{files.index(path) + 1:03d}{path.suffix}"
new_path = path.with_name(new_name)
print(f"{path.name} -> {new_path.name}")
if not dry_run:
path.rename(new_path)
更严谨的写法是使用enumerate()直接取得序号,避免反复调用files.index(path)。同时,可以把每次改名记录到文本日志中,记录时间、原路径和新路径,方便之后核对或恢复。
对于来自网络的文件,文件名可能含有特殊字符、过长文本或相同名称。整理文章示例这类网页内容时,最好先清理斜杠、冒号和换行符,再进行批量命名。
处理子文件夹和异常情况
iterdir()只会读取当前目录。如果还要处理子文件夹,可以使用rglob("*")递归查找文件。不过递归操作范围更大,容易误触碰不应修改的目录,因此应先限定文件后缀或指定目录层级。
for path in folder.rglob("*"):
if not path.is_file():
continue
if path.suffix.lower() not in {".jpg", ".jpeg", ".png"}:
continue
new_path = path.with_name(f"图片_{path.stem}{path.suffix}")
print(path, "->", new_path)
权限不足、文件正在被其他程序占用、路径包含非法字符,都可能造成异常。可以使用try...except捕获OSError,让脚本跳过问题文件并继续处理,同时把错误信息输出到终端。
try:
path.rename(new_path)
except OSError as error:
print(f"处理失败:{path.name},原因:{error}")
安全的批量重命名流程应当是:确认目录、筛选文件、生成新名称、预览变化、检查重名、备份原始文件,最后才执行改名。掌握pathlib的stem、suffix、iterdir()和rename()后,就能灵活实现前缀添加、序号排列、日期标记和类型筛选等功能。
无论文件来自照片相机、办公软件还是网络下载,保留扩展名都能维持系统对文件类型的识别。真正需要记住的是:先把主文件名与扩展名分开处理,再用预览和重名检查保护原始数据。