用 Python 的 pathlib 批量整理文件：让重复操作自动化

日常开发中，我们经常需要整理下载目录、归档日志文件，或者按照文件类型批量分类资料。文件数量少时，手动操作还算方便；一旦涉及几百个文件，重复点击不仅耗时，也容易出错。

Python 的 pathlib 模块提供了直观的路径操作方式，配合 shutil 就能实现文件分类和移动。下面以整理下载目录为例，介绍一种简单、可复用的实现方法。

一、使用 pathlib 遍历文件

pathlib 可以将文件路径作为对象处理，不必频繁拼接字符串。通过 Path.iterdir()，我们可以遍历指定目录下的文件和子目录；通过 suffix 获取扩展名，并统一转换为小写，避免 .JPG 和 .jpg 被区别处理。

例如：

from pathlib import Path

folder = Path("./downloads")

for file in folder.iterdir():
    if file.is_file():
        print(file.name, file.suffix.lower())

这段代码只读取当前目录的第一层，不会自动遍历子目录。先打印文件信息，可以帮助我们确认程序实际处理的范围。

二、按照文件类型自动分类

假设我们希望将图片、文档和压缩包分别放入不同文件夹，可以建立一个扩展名映射表，再根据文件类型决定目标目录。

import shutil
from pathlib import Path

root = Path("./downloads")
groups = {
    ".jpg": "图片", ".png": "图片",
    ".pdf": "文档", ".docx": "文档",
    ".zip": "压缩包"
}
dry_run = True  # 先预览，不立即移动

for file in root.iterdir():
    if not file.is_file():
        continue
    category = groups.get(file.suffix.lower())
    if not category:
        continue

    target_dir = root / category
    target = target_dir / file.name
    if target.exists():
        print(f"跳过重名文件：{file.name}")
        continue

    print(f"{file} -> {target}")
    if not dry_run:
        target_dir.mkdir(parents=True, exist_ok=True)
        shutil.move(str(file), str(target))

这里有两个关键点：第一，dry_run = True 时只输出移动计划，不修改文件；确认结果符合预期后，再改为 False 执行。第二，移动前检查目标路径，避免覆盖已经存在的同名文件。

三、实际使用时要注意什么

批量处理文件时，不应只关注代码能否运行，还要考虑异常情况。

首先，建议使用明确的目标目录，避免误处理其他重要文件。其次，可以根据实际需求扩展映射表，例如增加 .xlsx、.mp4 等格式。对于需要递归处理的目录，可以考虑 Path.rglob()，但应先确认不会重复处理分类目录中的文件。

如果文件来自共享目录或重要业务环境，建议先备份，再进行批量操作。对于可能被其他程序同时修改的文件，也应增加必要的状态检查。

小结

pathlib 负责清晰地管理路径，shutil 负责执行文件移动，两者结合就能完成一个实用的批量整理工具。开发这类自动化脚本时，先预览、再执行，并主动处理重名和异常情况，往往比追求代码简短更重要。

适合华为云开发者社区「每日发布文章」任务投稿