怎么用Python脚本批量重命名文件和整理文件夹

Finn
Finn
发布时间:2026-11-21 | 7人浏览过
原创

本文详细介绍如何使用Python标准库pathlib和shutil编写脚本,实现批量重命名文件、按扩展名分类与按日期整理文件夹,并提供防覆盖的安全防护实践。

使用Python进行批量文件处理,本质上是借助标准库中的 pathlib 与 shutil 模块,对目标路径下的文件进行遍历、模式匹配与元数据分析,随后执行重命名或移动操作。只需几十行代码,就能安全自动化地解决数百乃至上万个杂乱文件的归档问题。

一、核心思路与操作全景流程

无论批量任务的具体规则如何变化,一个稳健的Python文件处理脚本通常遵循固定的四个环节:扫描目标目录、筛选符合条件的目标文件、根据规则生成新路径并进行模拟预演(Dry-Run)、最终写入执行。将“计算新文件名”与“真正改写硬盘”严格分离,是防止误操作损坏重要资料的核心防护手段。

怎么用Python脚本批量重命名文件和整理文件夹
图1:批量文件重命名与整理的标准四步流水线架构

二、标准库选型对比:pathlib 与 os.path 的关键差异

在编写自动化文件处理脚本时,很多开发者习惯使用传统的 os 和 os.path 模块,但现代Python更推荐使用 pathlib.Path。这两者在底层都可以实现文件操作,但在语法设计与安全可靠性上存在本质差异。

传统 os.path 将文件路径视为普通字符串,对路径的拼接、后缀截取全部依赖于纯字符串分割(如 os.path.splitext)与拼接(os.path.join)。当遇到包含多个句点的复杂文件名时,手动切片极易截错后缀;同时,不同操作系统的路径分隔符(Windows的斜杠与反斜杠)在纯字符串拼接中容易产生转义失误。而 pathlib.Path 采用面向对象设计,路径是独立对象,具备 .stem(纯文件名)、.suffix(文件后缀)、.parent(所在父目录)等内置属性,语法直观且平台无关。

怎么用Python脚本批量重命名文件和整理文件夹
图2:os 字符串模型与 pathlib 面向对象模型的关键特性对比

三、场景一:按规则批量重命名文件

常见的重命名需求通常包含:统一添加前缀/后缀、关键词替换,以及按顺序格式化编号(如 001、002 对齐)。在重命名时,切记将 stem(文件名主干)与 suffix(文件后缀扩展名)分开处理,避免改名时丢失扩展名导致系统无法关联打开软件。

下面是一个带有完整“预演保护(dry_run)”功能的批量重命名脚本。设置 dry_run = True 时,控制台仅输出改名前后的对照信息,不改写任何磁盘数据;确认无误后改为 dry_run = False 再真正执行。

from pathlib import Path

def batch_rename_files(directory_path, prefix="Doc_", start_index=1, dry_run=True):
    target_dir = Path(directory_path)
    
    if not target_dir.exists() or not target_dir.is_dir():
        print(f"错误:指定目录不存在或不是文件夹:{target_dir}")
        return

    # 筛选出所有普通文件并按原名称字母序排序
    files = sorted([f for f in target_dir.iterdir() if f.is_file()])
    
    print(f"共发现 {len(files)} 个文件,模式:{'【模拟预演 - 不修改磁盘】' if dry_run else '【正式执行】'}\n")
    
    renamed_count = 0
    for idx, file_item in enumerate(files, start=start_index):
        # 3位数字补零对齐,例如 001, 002
        new_name = f"{prefix}{idx:03d}{file_item.suffix.lower()}"
        new_path = file_item.parent / new_name

        if new_path == file_item:
            continue

        # 防覆盖检查:目标文件如果已存在,则跳过并警告
        if new_path.exists():
            print(f"[跳过] 目标已存在同名文件: {new_name}")
            continue

        if dry_run:
            print(f"[预览] {file_item.name} -> {new_name}")
        else:
            file_item.rename(new_path)
            print(f"[已重命名] {file_item.name} -> {new_name}")
            
        renamed_count += 1

    print(f"\n处理完成,共计操作 {renamed_count} 个文件。")

if __name__ == "__main__":
    # 执行前请修改为读者的实际路径
    batch_rename_files("./test_files", prefix="Project_Report_", start_index=1, dry_run=True)
代码细节说明: idx:03d 是 Python 的格式化语法,表示将整数格式化为至少 3 位宽度的十进制数字,不足部分自动在左侧填充零。对齐位数能够确保系统资源管理器按文件名升序排列时保持严格顺序,不会出现 10 排在 2 前面的情况。

四、场景二:按文件扩展名自动归类整理

桌面或“下载”文件夹中往往混杂了各种图片、文档、音频和压缩包。通过判断文件的扩展名(file.suffix),将其动态归档到专属命名的子文件夹中,是整理文件最常用的手段。

怎么用Python脚本批量重命名文件和整理文件夹
图3:基于文件扩展名映射规则的自动归类分拣流程

实现该逻辑的核心是构建一个“后缀映射字典”。配合 shutil.move,可以轻松把文件移入目标子文件夹。以下是完整代码:

from pathlib import Path
import shutil

# 定义分类字典:文件夹名称 -> 包含的扩展名集合
EXTENSION_MAPPING = {
    "文档资料": [".pdf", ".docx", ".doc", ".txt", ".md"],
    "图片照片": [".jpg", ".jpeg", ".png", ".gif", ".webp", ".svg"],
    "表格数据": [".xlsx", ".xls", ".csv"],
    "压缩归档": [".zip", ".rar", ".7z", ".tar", ".gz"],
    "安装程序": [".exe", ".dmg", ".pkg", ".msi"]
}

def organize_by_extension(source_directory, dry_run=True):
    src_dir = Path(source_directory)
    if not src_dir.is_dir():
        print("指定路径无效。")
        return

    # 预先生成反向查表字典:.pdf -> 文档资料
    ext_to_folder = {}
    for folder_name, extensions in EXTENSION_MAPPING.items():
        for ext in extensions:
            ext_to_folder[ext.lower()] = folder_name

    # 仅遍历当前目录的第一级文件,不深入已有子文件夹
    files = [f for f in src_dir.iterdir() if f.is_file()]

    for file_path in files:
        ext = file_path.suffix.lower()
        # 未在分类表中的归入“其他杂项”
        target_subfolder = ext_to_folder.get(ext, "其他杂项")
        dest_folder = src_dir / target_subfolder
        dest_path = dest_folder / file_path.name

        if dry_run:
            print(f"[待整理] {file_path.name} -> {target_subfolder}/")
        else:
            # 确保目标文件夹已创建(parents=True允许创建中间目录,exist_ok=True避免已存在报错)
            dest_folder.mkdir(parents=True, exist_ok=True)
            
            # 如果目标文件夹内已存在同名文件,添加计数后缀避免强行覆盖
            if dest_path.exists():
                stem = file_path.stem
                counter = 1
                while dest_path.exists():
                    dest_path = dest_folder / f"{stem}_{counter}{ext}"
                    counter += 1
            
            shutil.move(str(file_path), str(dest_path))
            print(f"[已归档] {file_path.name} -> {dest_path.relative_to(src_dir)}")

if __name__ == "__main__":
    organize_by_extension("./my_downloads", dry_run=True)

五、场景三:按修改时间归档日志与照片

针对拍摄的照片或服务器生成的日常日志,按年-月(如 2024-03)自动建立文件夹归档是保持文件系统整洁的另一利器。我们可以通过文件的 stat().st_mtime 获取时间戳并解析为日期格式:

from pathlib import Path
from datetime import datetime
import shutil

def organize_by_date(source_directory, dry_run=True):
    src_dir = Path(source_directory)
    files = [f for f in src_dir.iterdir() if f.is_file()]

    for f in files:
        # 获取最后修改时间
        mtime = f.stat().st_mtime
        date_folder_name = datetime.fromtimestamp(mtime).strftime("%Y-%m")
        
        target_dir = src_dir / date_folder_name
        target_file = target_dir / f.name

        if dry_run:
            print(f"[预演归档] {f.name} -> {date_folder_name}/")
        else:
            target_dir.mkdir(parents=True, exist_ok=True)
            if not target_file.exists():
                shutil.move(str(f), str(target_file))
            else:
                print(f"[警告] 目标位置已存在文件: {target_file.name},本次跳过。")

if __name__ == "__main__":
    organize_by_date("./camera_photos", dry_run=True)

六、批量操作的安全防范机制与常见陷阱

批量处理属于高风险操作,一旦代码逻辑产生漏洞或命名规则冲突,极易引发大批量文件覆盖或丢失。因此,编写脚本时必须严格部署以下防护机制:

潜在风险 产生原因 防护手段与推荐解法
静默覆盖已有文件 在 Windows 等系统上,Path.rename() 在目标存在时可能直接覆盖 在操作前显式执行 if target.exists(): 检查,或自动追加递增序号 _1, _2。
跨分区移动异常 Path.rename() 底层是原子重命名系统调用,无法直接跨磁盘驱动器(如 C盘 到 D盘) 跨驱动器或网络共享目录移动时,使用 shutil.move(),它会自动处理复制与删除。
大小写敏感性问题 Windows 与 macOS 默认文件系统对大小写不敏感,而 Linux 敏感 单纯修改大小写(如 test.JPG 改为 test.jpg)在 Windows 下可能失败,需借助临时中转名称过渡。
递归死循环 使用 rglob() 遍历的同时在同一目录下新建子文件夹并移动文件 遍历前先生成静态列表 files = list(src.iterdir()),将“扫描”与“写入”生命周期彻底隔开。
怎么用Python脚本批量重命名文件和整理文件夹
图4:文件批处理脚本必不可少的四道核心安全防线

七、总结

通过 Python 脚本进行批量文件处理,不仅能够将数小时的手工机械劳动缩减至数秒完成,而且能确保重命名和归档的标准高度统一。牢记以 pathlib.Path 作为核心工具,遵循“静态列表扫描 → 规则生成 → 干运行预演 → 安全写入”的执行流程,就能在保证数据绝对安全的前提下,轻松驾驭任何复杂的日常文件整理任务。

相关专题:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表