在数字时代，我们每天都会接触海量文件。例如拍了一大堆照片，文件名全是IMG_20230515_1234.jpg这种格式，想统一改成“项目A_20230515_1234.jpg”——如果手动操作，简直就是给自己添堵。其实，用Python就能轻松搞定。今天这篇文章，就来详细介绍如何借助os和shutil等核心模块，配合循环语句，实现批量文件重命名。这不仅是编程技巧，更是一种解放双手的生产力革命。

为什么需要批量重命名？真实痛点分析

“我昨天整理了300张工作照片，每个文件名都是IMG_20230515_1234.jpg，现在需要改成项目A_20230515_1234.jpg——手动操作？我宁愿去搬砖！”——这是许多设计师和办公人员的真实心声。

统计显示，73%的办公人员每周要花超过2小时处理文件命名问题（来源：Forrester Research 2023）。而Python的os模块，正是解决这一痛点的利器。

核心模块解析：os与shutil的黄金组合

os模块：操作系统交互的瑞士军刀

import os

# 获取当前工作目录
print(os.getcwd())  # 输出：/Users/yourname/Documents

# 列出目录内容（不包含子目录）
print(os.listdir("photos"))  # ['IMG_001.jpg', 'IMG_002.jpg', ...]

# 检查文件是否存在
if os.path.exists("report.pdf"):
    print("文件存在！")

shutil模块：高级文件操作助手

import shutil

# 复制文件（保留元数据）
shutil.copy("source.txt", "backup.txt")

# 移动文件（等同于重命名）
shutil.move("old_name.txt", "new_name.txt")

重命名文件时，os.rename()是最直接的方式，而shutil.move()在处理跨分区移动时更加安全。

基础实战：5行代码实现批量重命名

先从一个最简单的场景开始：给当前目录下所有的.jpg文件前面都加上一个前缀photo_。

import os

# 定义目标目录
folder = "photos"

# 遍历目录下所有文件
for filename in os.listdir(folder):
    # 仅处理.jpg文件
    if filename.endswith(".jpg"):
        # 生成新文件名
        new_name = "photo_" + filename
        
        # 执行重命名（必须使用完整路径）
        old_path = os.path.join(folder, filename)
        new_path = os.path.join(folder, new_name)
        
        os.rename(old_path, new_path)
        print(f"✅ 已重命名: {filename} → {new_name}")

执行效果预览

✅ 已重命名: IMG_001.jpg → photo_IMG_001.jpg
✅ 已重命名: IMG_002.jpg → photo_IMG_002.jpg
✅ 已重命名: IMG_003.jpg → photo_IMG_003.jpg

为什么必须用os.path.join？

直接拼接字符串folder + "/" + filename在Windows系统上会出错。os.path.join会自动处理路径分隔符（Windows用\，Linux/Mac用/），这才是跨平台的正确做法。

重命名流程的可视化：Mermaid动态演示

这个流程图清晰地展示了批量重命名的核心逻辑：过滤→重命名→冲突处理→循环执行。在实际代码中，我们通过if条件过滤和try-except来处理冲突。

常见陷阱：重名冲突与错误处理

看起来很简单对不对？但实际工作中，有一个很常见的坑：重名冲突。当目标文件名已存在时，os.rename()会直接抛出FileExistsError。因此，必须加上错误处理逻辑。

正确处理方案（带重名冲突解决）

import os

folder = "documents"
counter = 1  # 用于重名时的编号

for filename in os.listdir(folder):
    if filename.endswith(".txt"):
        # 生成基础新名称
        base_name = os.path.splitext(filename)[0]  # 移除后缀
        new_name = f"report_{base_name}.txt"
        
        # 检查是否已存在
        while os.path.exists(os.path.join(folder, new_name)):
            new_name = f"report_{base_name}_{counter}.txt"
            counter += 1
        
        # 执行重命名
        os.rename(
            os.path.join(folder, filename),
            os.path.join(folder, new_name)
        )
        print(f"✅ 重命名: {filename} → {new_name}")

关键技巧解析

1. os.path.splitext(filename)：分离文件名和扩展名（返回元组('report', '.txt')）。
2. 动态编号：用counter自动添加后缀，避免覆盖。
3. while循环：持续检查，直到生成一个唯一的文件名。

为什么用while而不是if？

因为可能有多个文件需要重命名，counter需要全局递增，否则会出现report_202301.txt和report_202301_1.txt这类冲突。

进阶场景：批量修改文件后缀

再来一个常见需求：把所有.png文件批量转换为.webp格式。注意，这里需要借助Pillow库来完成格式转换。

import os
from PIL import Image

folder = "images"

for filename in os.listdir(folder):
    if filename.endswith(".png"):
        # 生成新文件名
        new_name = os.path.splitext(filename)[0] + ".webp"
        
        # 转换图片格式
        img = Image.open(os.path.join(folder, filename))
        img.save(os.path.join(folder, new_name), "WEBP")
        
        # 删除原文件（可选）
        os.remove(os.path.join(folder, filename))
        print(f"✅ 转换: {filename} → {new_name}")

Pillow库安装：pip install pillow

图片格式转换需要额外库，但重命名操作本身的核心逻辑，仍然是用os模块完成的。

正则表达式：高级文件名处理神器

当文件名结构复杂、有规律可循时，正则表达式（Regex）就是终极武器。比如，想把IMG_20230515_1234.jpg改成20230515_1234.jpg。

正则表达式原理

完整代码实现

import os
import re

folder = "photos"

for filename in os.listdir(folder):
    # 使用正则匹配文件名
    match = re.match(r'IMG_(d{8})_(d{4}).jpg', filename)
    
    if match:
        # 提取捕获组
        date = match.group(1)
        number = match.group(2)
        
        # 生成新文件名
        new_name = f"{date}_{number}.jpg"
        
        # 执行重命名
        os.rename(
            os.path.join(folder, filename),
            os.path.join(folder, new_name)
        )
        print(f"✅ 重命名: {filename} → {new_name}")

优化技巧：进度显示与日志记录

处理大量文件时，一个直观的进度条能极大提升用户体验。这里推荐tqdm库，几行代码就能实现漂亮的可视化进度。

import os
from tqdm import tqdm  # pip install tqdm

folder = "videos"
files = [f for f in os.listdir(folder) if f.endswith(".mp4")]

for filename in tqdm(files, desc="重命名中"):
    # 重命名逻辑（此处省略）
    new_name = "video_" + filename
    os.rename(os.path.join(folder, filename), os.path.join(folder, new_name))

print("✅ 所有文件重命名完成！")

效果预览

重命名中: 100%|████████████████████████████| 50/50 [00:02<00:00, 24.50it/s]
✅ 所有文件重命名完成！

为什么推荐tqdm？

它自动计算进度、显示剩余时间，比手动写print(f"处理中 {i}/{total}")专业得多，也更直观。

递归处理子目录：批量操作扩展

如果文件分散在多级子目录里，os.walk()就是你的救星。它可以递归遍历所有层级的目录。

import os

def rename_recursive(folder):
    for root, _, files in os.walk(folder):
        for filename in files:
            if filename.endswith(".docx"):
                # 生成新名称（保留目录结构）
                new_name = "doc_" + filename
                old_path = os.path.join(root, filename)
                new_path = os.path.join(root, new_name)
                
                os.rename(old_path, new_path)
                print(f"✅ 递归重命名: {old_path} → {new_path}")

rename_recursive("projects")

os.walk()工作原理

• root：当前遍历的目录路径
• _：子目录列表（这里忽略）
• files：当前目录下的文件列表

重要提示：os.walk()会递归遍历所有子目录，确保不会遗漏任何深处的文件。

安全实践：备份与测试运行

永远不要在生产环境直接执行重命名操作！ 先来一次模拟运行，这是资深玩家的基本素养。

import os

folder = "photos"
dry_run = True  # 模拟运行开关

for filename in os.listdir(folder):
    if filename.endswith(".jpg"):
        new_name = "photo_" + filename
        
        if dry_run:
            print(f"模拟重命名: {filename} → {new_name}")
        else:
            os.rename(
                os.path.join(folder, filename),
                os.path.join(folder, new_name)
            )
            print(f"✅ 实际重命名: {filename} → {new_name}")

print("⚠️ 请将dry_run设为False后执行实际重命名！")

安全守则：

1. 先用dry_run=True测试
2. 重要操作前备份文件
3. 使用版本控制系统（如Git）记录变更

实际应用场景对比表

深度思考：为什么循环是核心？

批量重命名的本质，就是对每个文件执行相同的操作，这正是循环最擅长的场景。想象一下，如果没有循环，代码会变成什么样：

# 没有循环的糟糕写法（仅处理3个文件）
os.rename("IMG_001.jpg", "photo_IMG_001.jpg")
os.rename("IMG_002.jpg", "photo_IMG_002.jpg")
os.rename("IMG_003.jpg", "photo_IMG_003.jpg")

问题：文件数量一变，你就得手动去改代码。而循环让代码变得可扩展、可维护，这才是真正的生产力。

专家级技巧：动态文件名生成

更高级的玩法，是根据文件内容动态生成名字。比如，从PDF文件中提取标题，作为文件名。

import os
import PyPDF2

def extract_title(pdf_path):
    with open(pdf_path, "rb") as f:
        reader = PyPDF2.PdfReader(f)
        # 提取第一页的标题
        return reader.pages[0].extract_text().splitlines()[0].strip()

folder = "pdfs"

for filename in os.listdir(folder):
    if filename.endswith(".pdf"):
        try:
            title = extract_title(os.path.join(folder, filename))
            # 清理非法字符
            safe_title = re.sub(r'[\/*?:"<>|]', "", title)
            new_name = f"{safe_title}.pdf"
            
            os.rename(
                os.path.join(folder, filename),
                os.path.join(folder, new_name)
            )
            print(f"✅ 提取标题: {filename} → {new_name}")
        except Exception as e:
            print(f"❌ 处理失败 {filename}: {str(e)}")

这里用PyPDF2库来提取PDF内容，并用re.sub清理掉文件名中Windows系统禁用的字符（如\ / : * ? " < > |），这可是个极其实用的技巧。

为什么这个方案比其他工具更好？

关键洞察：自动化脚本是唯一能应对1000+文件的方案。根据2023年IT效率报告，使用脚本的团队比手动操作效率高出整整17倍。

实际案例：电商产品图片批量重命名

来看一个真实的业务场景：某电商团队需要将产品图片按ID重命名。

• 原文件名：product_12345.jpg
• 目标文件名：P12345.jpg

import os
import re

folder = "products"

for filename in os.listdir(folder):
    if filename.endswith(".jpg"):
        # 提取数字ID
        match = re.search(r'product_(d+)', filename)
        if match:
            id_num = match.group(1)
            new_name = f"P{id_num}.jpg"
            
            os.rename(
                os.path.join(folder, filename),
                os.path.join(folder, new_name)
            )
            print(f"✅ 产品重命名: {filename} → {new_name}")

为什么这样设计？

• 正则表达式精准匹配product_后的数字
• P前缀符合电商命名规范
• 保留原扩展名避免格式错误

高级技巧：按日期排序重命名

如果想按文件的创建时间来重命名，比如生成20230515_0830.jpg这样的文件名，可以这样做：

import os
from datetime import datetime

folder = "travel"

for filename in os.listdir(folder):
    if filename.endswith(".jpg"):
        # 获取文件创建时间
        file_path = os.path.join(folder, filename)
        timestamp = os.path.getctime(file_path)
        dt = datetime.fromtimestamp(timestamp)
        
        # 格式化为YYYYMMDD_HHMM
        new_name = dt.strftime("%Y%m%d_%H%M") + ".jpg"
        
        os.rename(file_path, os.path.join(folder, new_name))
        print(f"✅ 按时间重命名: {filename} → {new_name}")

这里，os.path.getctime获取创建时间（Windows/Mac），os.path.getmtime则获取修改时间，按需选用。

最后警告：避免常见致命错误

错误1：忘记使用完整路径

# 错误示例！
os.rename("IMG_001.jpg", "photo_IMG_001.jpg") 
# 实际执行时会报错：文件不在当前目录

正确写法

os.rename(
    os.path.join("photos", "IMG_001.jpg"),
    os.path.join("photos", "photo_IMG_001.jpg")
)

错误2：重命名后未更新文件列表

# 错误示例：循环中修改文件名导致跳过
for filename in os.listdir("photos"):
    if filename.endswith(".jpg"):
        os.rename(..., "new_" + filename)  # 但循环仍用原文件名

正确写法

# 先收集所有文件，再重命名
files = [f for f in os.listdir("photos") if f.endswith(".jpg")]
for filename in files:
    # 重命名逻辑

附录：关键函数速查表

总结：掌握批量重命名的终极价值

1. 效率提升：从小时级操作压缩到秒级完成
2. 错误减少：消除手动输入的拼写错误
3. 工作流整合：可嵌入自动化脚本（如CI/CD管道）
4. 技能迁移：核心编程思维（循环、条件、文件操作）可应用于所有场景

“当你的文件超过100个，批量重命名就不是便利，而是生存必需。” ——《Python自动化编程》作者

未来展望：AI驱动的智能重命名

随着AI技术发展，未来可能会实现更智能的重命名：

• 从图片内容自动生成文件名（如“海滩日落_20230515.jpg”）
• 自动识别文档类型并应用命名规则
• 云端协作的智能重命名服务

但基础技能永远是核心——掌握了os模块与循环的结合，你已经站在了自动化时代的起点。