Python文件重命名案例如何修改名称

wen python案例 2026-07-01 22

Python文件重命名案例：如何优雅修改文件名？手把手教程与常见问题解析

目录导读

引言：为何需要批量重命名？
基础准备：Python文件操作核心库os与pathlib
实战案例一：单个文件重命名（os.rename）
实战案例二：批量替换文件名中的特定字符串
实战案例三：利用正则表达式智能重命名
实战案例四：为文件添加序号或日期前缀
问答环节（FAQ）
避坑指南：常见错误与最佳实践
自动化思维提升效率

引言：为何需要批量重命名？

在日常生活中，我们经常遇到这样的场景：从网上下载大量图片（如photo (1).jpg、photo (2).jpg），或者整理项目文件时发现命名混乱（如report_final_v2_最终版.doc），手动一个一个修改既费时又容易出错，使用Python只需几行代码，就能实现精确、快速、可重复的文件重命名。

Python文件重命名案例如何修改名称

本文基于百度、谷歌等搜索引擎中高频出现的Python重命名问题，综合实际开发经验，提供从基础到进阶的完整解决方案,所有案例均附有可运行的代码及解释。

基础准备：Python文件操作核心库os与pathlib

Python中处理文件重命名主要依赖两个内置库：

os模块：传统方式，提供os.rename(src, dst)函数。
pathlib模块：Python 3.4+引入的面向对象方法，推荐使用,更直观安全。

安装说明：两者均为内置库，无需额外安装，使用前只需import os或from pathlib import Path。

基础代码结构：

import os
# 使用os模块
os.rename("旧文件名.txt", "新文件名.txt")
# 使用pathlib模块（推荐）
from pathlib import Path
path = Path("旧文件名.txt")
path.rename("新文件名.txt")

注意：重命名操作不可逆,建议先在小范围测试。

实战案例一：单个文件重命名（os.rename）

场景：将当前目录下的old_report.docx改为new_report.docx。

代码实现：

import os
old_name = "old_report.docx"
new_name = "new_report.docx"
if os.path.exists(old_name):
    os.rename(old_name, new_name)
    print(f"成功将 {old_name} 重命名为 {new_name}")
else:
    print(f"文件 {old_name} 不存在")

关键点：

需确保目标路径的文件夹存在,否则会报错。
若new_name已存在，会直接覆盖（谨慎使用）。

实战案例二：批量替换文件名中的特定字符串

场景：将文件夹内所有_backup替换为_v2（如data_backup.csv → data_v2.csv）。

代码实现：

import os
folder_path = "./files"  # 替换为你的文件夹路径
old_str = "_backup"
new_str = "_v2"
for filename in os.listdir(folder_path):
    if old_str in filename:
        # 构建新旧完整路径
        old_path = os.path.join(folder_path, filename)
        new_filename = filename.replace(old_str, new_str)
        new_path = os.path.join(folder_path, new_filename)
        # 执行重命名
        os.rename(old_path, new_path)
        print(f"已重命名：{filename} -> {new_filename}")
print("批量替换完成！")

优化建议：使用pathlib更好处理路径拼接,且支持递归遍历子文件夹。

实战案例三：利用正则表达式智能重命名

场景：将文件名中的日期格式从2024-01-15_report.txt改为report_20240115.txt（提取日期并移到末尾）。

代码实现：

import re
from pathlib import Path
folder = Path("./documents")
pattern = r"(\d{4})-(\d{2})-(\d{2})_(.*)\.txt"  # 匹配规则
for file_path in folder.iterdir():
    if file_path.is_file():
        match = re.match(pattern, file_path.name)
        if match:
            year, month, day, base_name = match.groups()
            new_name = f"{base_name}_{year}{month}{day}.txt"
            new_path = file_path.parent / new_name
            # 避免重名覆盖
            if not new_path.exists():
                file_path.rename(new_path)
                print(f"重命名：{file_path.name} → {new_name}")
            else:
                print(f"警告：{new_name}已存在，跳过")

核心技巧：正则表达式让文件名解析变得灵活强大,适合复杂规则。

实战案例四：为文件添加序号或日期前缀

场景：将当前目录的所有.jpg图片按修改时间排序，添加三位序号前缀（001_photo.jpg, 002_photo.jpg...）。

代码实现：

from pathlib import Path
import os
folder = Path("./images")
# 按修改时间排序的文件列表
files = sorted(folder.glob("*.jpg"), key=lambda f: f.stat().st_mtime)
for idx, file_path in enumerate(files, start=1):
    new_name = f"{idx:03d}_{file_path.name}"  # 格式化为001, 002...
    new_path = file_path.parent / new_name
    file_path.rename(new_path)
    print(f"重命名：{file_path.name} → {new_name}")
print(f"共处理 {idx} 个文件")

扩展应用：可改为添加当前日期（20250319_photo.jpg），使用datetime模块即可。

问答环节（FAQ）

Q1：为什么我的os.rename报错“文件不存在”？
A：请检查文件路径是否正确，尤其是相对路径（当前工作目录），建议使用绝对路径或先print(os.getcwd())查看当前目录，或使用pathlib.Path.resolve()获取绝对路径。

Q2：能否跨磁盘重命名文件？
A：os.rename本质上是“移动”操作，如果新旧路径在不同磁盘（如C盘到D盘），会复制后删除源文件，并可能跨文件系统，建议使用shutil.move()更安全,它会自动处理跨盘移动。

Q3：批量重命名时如何防止覆盖已有文件？
A：可在重命名前使用os.path.exists(new_path)或new_path.exists()检查，如案例三所示，也可先生成新名称列表,统一校验后再执行。

Q4：如何递归处理子文件夹中的所有文件？
A：使用pathlib.Path.rglob("*")或os.walk(),示例：

for file_path in folder.rglob("*"):
    if file_path.is_file():
        # 重命名逻辑
        pass

Q5：有没有现成的GUI工具代替Python？
A：有，如Advanced Renamer、Bulk Rename Utility，但Python更适合批量、定制化、可复用场景,且能嵌入到自动化流程中。

避坑指南：常见错误与最佳实践

常见错误	正确做法
忘记检查文件是否存在直接rename	先判断文件存在性，使用`if path.exists()`
新文件名与旧文件名相同	检查新旧名称是否一致，避免无意义操作
批量操作时出现异常中断	使用try-except捕获异常，或记录日志
非空文件夹重命名失败	`os.rename`不可直接重命名非空文件夹，需使用`shutil.move`

最佳实践：

测试先行：先在少量文件上运行,确认规则无误。
备份原始文件：批量操作前复制一份到临时目录。
使用pathlib：代码更简洁,路径处理更安全。
打印日志：每步操作都输出当前处理结果,方便回溯。

自动化思维提升效率

通过本文的4个案例，你已掌握从简单单个重命名到复杂正则替换、排序前缀的核心技巧，实际工作中，你可以将这些代码封装成函数或脚本,一键处理任意文件夹。

下一步行动建议：

在测试目录创建几个示例文件，运行案例中代码。
根据自己的需求修改正则表达式，实现定制化重命名。
尝试结合tkinter或click库,制作带交互界面的重命名工具。

最后提醒：自动化重命名是高效文件管理的第一步，但永远记得备份和测试，如果你有更特殊的重命名需求,欢迎在评论区留言探讨。