用Python一键整理文件：自动分类DOCX与PDF，告别文件夹杂乱

用Python一键整理文件：自动分类DOCX与PDF，告别文件夹杂乱

你是否经常面对这样的场景：下载的文档、工作报告、学习资料混在一个文件夹里，DOCX和PDF文件杂乱无章，想找一个文件需要翻半天？手动新建文件夹、逐个移动文件不仅浪费时间，还容易遗漏或误操作。

今天，我们将实现一个零依赖的Python自动化脚本——只需指定目标文件夹，它就能自动识别DOCX和PDF文件，分别移动到专属子文件夹中，还能实时反馈移动进度、统计文件数量，并处理异常情况（如文件被占用）。即使是Python新手，也能3分钟上手！

一、环境准备：零依赖，开箱即用

这个脚本的核心优势之一是无需安装任何第三方库，完全基于Python标准库开发，兼容性极强。只要你的电脑安装了Python（3.4及以上版本），就能直接运行。

1. 核心依赖库（均为Python标准库）

脚本中用到的3个库均随Python默认安装，无需额外执行pip install：

• os：辅助路径处理（本脚本中主要用于配合Path对象，确保路径兼容性）。
• shutil：提供文件移动、复制等核心操作，是实现“整理文件”的关键。
• pathlib.Path：Python 3.4+引入的路径操作库，比传统的os.path更简洁、更直观，还能自动处理Windows/macOS/Linux的路径差异（如\和/）。

2. Python版本要求

推荐使用Python 3.6及以上版本（Path.glob方法在3.4+已支持，但高版本在异常处理和编码兼容性上更优）。

3. 跨平台支持

脚本可在Windows、macOS、Linux系统上直接运行，仅需修改“源目录路径”（如Windows的D:\data、macOS的/Users/xxx/Documents），无需调整代码逻辑。

二、完整源代码以及解析：

先看完整可运行代码，再分模块拆解核心逻辑，帮你吃透每一步的设计思路：

import os
import shutil
from pathlib import Pathdef organize_files(source_dir):# 转换为Path对象source_path = Path(source_dir)# 创建目标文件夹docx_folder = source_path / "docx"pdf_folder = source_path / "pdf"# 确保目标文件夹存在docx_folder.mkdir(exist_ok=True)pdf_folder.mkdir(exist_ok=True)# 计数器docx_count = 0pdf_count = 0# 获取源目录中的所有文件for file_path in source_path.glob("*"):# 跳过文件夹if file_path.is_dir():continue# 处理.docx文件if file_path.suffix.lower() == ".docx":target_path = docx_folder / file_path.nametry:shutil.move(str(file_path), str(target_path))docx_count += 1print(f"已移动: {file_path.name} -> docx文件夹")except Exception as e:print(f"移动 {file_path.name} 失败: {str(e)}")# 处理.pdf文件elif file_path.suffix.lower() == ".pdf":target_path = pdf_folder / file_path.nametry:shutil.move(str(file_path), str(target_path))pdf_count += 1print(f"已移动: {file_path.name} -> pdf文件夹")except Exception as e:print(f"移动 {file_path.name} 失败: {str(e)}")print(f"\n整理完成!")print(f"已移动 {docx_count} 个DOCX文件到 {docx_folder}")print(f"已移动 {pdf_count} 个PDF文件到 {pdf_folder}")if __name__ == "__main__":# 源目录source_directory = r"D:\data"organize_files(source_directory)

1. 核心函数：organize_files(source_dir)

这个函数是脚本的“心脏”，负责从“路径处理”到“文件移动”的全流程，我们分10个关键步骤拆解：

步骤1：路径对象化（source_path = Path(source_dir)）

• 为什么不用字符串路径？Path对象能自动处理不同系统的路径分隔符（Windows用\，macOS用/），比如在macOS中写source_directory = "/Users/xxx/data"，脚本也能正常运行，无需修改代码。
• 后续所有路径操作（如创建子文件夹、拼接文件名）都基于Path对象，代码更简洁。

步骤2-3：创建目标子文件夹

docx_folder = source_path / "docx"
pdf_folder.mkdir(exist_ok=True)

• source_path / "docx"：等价于在源目录下拼接“docx”子文件夹路径（类似字符串拼接，但更安全）。
• mkdir(exist_ok=True)：核心参数——如果“docx”文件夹已存在，不会报错；如果不存在，则自动创建。避免了手动判断“文件夹是否存在”的冗余代码。

步骤4：初始化计数器

• docx_count和pdf_count用于统计移动成功的文件数量，最终在控制台打印，让用户直观知道整理效果（比如“移动了5个DOCX、3个PDF”）。

步骤5：遍历源目录文件（source_path.glob("*")）

• glob("*")：遍历源目录下的所有内容（包括文件和子文件夹），返回一个迭代器。
• 后续用file_path.is_dir()跳过子文件夹，确保只处理“文件”，避免误移动用户已有的其他目录（比如源目录下已有“图片”文件夹，不会被脚本处理）。

步骤6-7：按文件类型移动（核心逻辑）

这是脚本的核心功能，以DOCX文件为例：

1. 后缀判断：file_path.suffix.lower() == ".docx"——suffix获取文件后缀（如.docx），lower()将后缀转为小写，确保.DOCX（大写）、.Docx（混合大小写）也能被识别，兼容性更强。
2. 目标路径拼接：target_path = docx_folder / file_path.name——file_path.name获取文件名（如“报告.docx”），确保移动后文件名不变，用户容易找到。
3. 文件移动：shutil.move(str(file_path), str(target_path))——shutil.move是Python标准库中用于“移动文件/目录”的函数，这里将Path对象转为字符串（部分旧版本shutil对Path支持不足，兼容处理）。
4. 异常捕获：try-except块是脚本“健壮性”的关键——如果文件被其他程序占用（如Word打开了“报告.docx”），脚本不会崩溃，而是打印错误原因（如“ PermissionError: [WinError 32] 另一个程序正在使用此文件”），并继续处理下一个文件。

步骤8：打印统计结果

• 整理完成后，清晰显示“移动了多少个文件”“移动到哪个路径”，避免用户“不知道有没有整理成功”的困惑。

2. 主程序入口（if __name__ == "__main__":）

• 定义“源目录”（source_directory）：这是用户唯一需要修改的地方，需填写你要整理的文件夹路径。
  • Windows示例：source_directory = r"D:\data"（r表示“原始字符串”，避免\被当作转义符，比如D:\data不会变成D:data）。
  • macOS/Linux示例：source_directory = "/Users/yourname/Documents"（直接用/分隔路径）。
• 调用organize_files(source_directory)：执行文件整理逻辑。

三、实战使用：3步完成文件整理

掌握代码逻辑后，我们以Windows系统为例，实际运行脚本，感受“一键整理”的便捷：

步骤1：修改“源目录”路径

打开脚本，找到source_directory = r"D:\data"，将路径改为你要整理的文件夹，比如：

source_directory = r"C:\Users\你的用户名\Desktop\杂乱文件"

提示：如果不知道文件夹路径，可以打开文件夹，在地址栏复制路径，直接粘贴到脚本中（Windows路径记得加r前缀）。

步骤2：运行脚本

1. 打开“命令提示符”（Win+R，输入cmd回车）。

2. 运行脚本（假设脚本名为file_organizer.py）：

   python file_organizer.py
   

步骤3：查看整理结果

运行后会看到类似以下的输出：

已移动: 项目方案.docx -> docx文件夹
已移动: 会议记录.DOCX -> docx文件夹（注意：大写后缀也能识别）
已移动: 产品手册.pdf -> pdf文件夹
移动 财务报表.pdf 失败: [WinError 32] 另一个程序正在使用此文件，进程无法访问。
已移动: 需求文档.docx -> docx文件夹整理完成!
已移动 3 个DOCX文件到 C:\Users\你的用户名\Desktop\杂乱文件\docx
已移动 1 个PDF文件到 C:\Users\你的用户名\Desktop\杂乱文件\pdf

• 打开源目录，会发现自动生成了docx和pdf两个子文件夹，所有未被占用的DOCX/PDF文件已分别移动到对应文件夹中。
• 失败的文件（如“财务报表.pdf”）会保留在源目录，关闭占用它的程序（如Adobe Reader）后，重新运行脚本即可移动。

四、常见问题与解决方案

在使用过程中，可能会遇到一些小问题，这里整理了高频场景及解决方法，帮你快速排查：

问题现象	可能原因	解决方案
脚本提示“移动失败：另一个程序正在使用此文件”	目标文件被Word、Adobe Reader等程序打开	关闭对应的程序（如关闭Word窗口、PDF阅读器），重新运行脚本
脚本提示“PermissionError：权限不足”	源目录或目标文件夹无写入权限（如系统目录、管理员创建的文件夹）	1. 右键点击“命令提示符”，选择“以管理员身份运行”； 2. 或把文件移动到非系统目录（如桌面、Documents）
脚本没移动任何文件，但源目录有DOCX/PDF	1. 源目录路径写错（如D:\data写成D:data）； 2. 文件后缀是.doc（非.docx）或.PDF（脚本已处理小写，此情况较少）	1. 核对source_directory路径，确保与文件夹地址栏一致； 2. 若为.doc文件，可手动转为.docx，或扩展脚本支持.doc
脚本报错“FileNotFoundError：[WinError 3] 系统找不到指定的路径”	源目录不存在（如D:\data文件夹未创建）	先在对应路径创建文件夹（如手动新建D:\data），再运行脚本

五、进阶扩展：让脚本更强大

基础脚本已能满足“分类DOCX/PDF”的需求，但我们还可以根据实际场景扩展功能，让它适配更多使用场景：

1. 支持更多文件类型（如TXT、JPG）

如果想同时整理TXT文档和JPG图片，只需添加对应的目标文件夹和判断逻辑：

# 新增目标文件夹
txt_folder = source_path / "txt"
jpg_folder = source_path / "jpg"
# 确保文件夹存在
txt_folder.mkdir(exist_ok=True)
jpg_folder.mkdir(exist_ok=True)
# 新增计数器
txt_count = 0
jpg_count = 0# 新增TXT文件处理逻辑
elif file_path.suffix.lower() == ".txt":target_path = txt_folder / file_path.nametry:shutil.move(str(file_path), str(target_path))txt_count += 1print(f"已移动: {file_path.name} -> txt文件夹")except Exception as e:print(f"移动 {file_path.name} 失败: {str(e)}")# 新增JPG文件处理逻辑（同理可添加.png、.gif等）
elif file_path.suffix.lower() in [".jpg", ".jpeg"]:target_path = jpg_folder / file_path.nametry:shutil.move(str(file_path), str(target_path))jpg_count += 1print(f"已移动: {file_path.name} -> jpg文件夹")except Exception as e:print(f"移动 {file_path.name} 失败: {str(e)}")# 最后更新统计结果
print(f"已移动 {txt_count} 个TXT文件到 {txt_folder}")
print(f"已移动 {jpg_count} 个JPG文件到 {jpg_folder}")

2. 处理子文件夹中的文件（递归整理）

默认脚本只处理“源目录一级目录”的文件，若想整理源目录下所有子文件夹中的DOCX/PDF，只需修改glob参数为**/*（递归匹配所有文件）：

# 原代码：只处理一级目录
# for file_path in source_path.glob("*"):
# 修改后：递归处理所有子文件夹中的文件
for file_path in source_path.glob("**/*"):

注意：递归整理时，仍会跳过子文件夹（if file_path.is_dir(): continue），只移动文件。

3. 避免同名文件覆盖

如果目标文件夹中已有同名文件（如docx文件夹已存在“报告.docx”），shutil.move会直接覆盖旧文件。若想避免覆盖，可在移动前判断目标路径是否存在，若存在则重命名（如“报告_1.docx”）：

# 以DOCX文件为例，修改目标路径逻辑
if file_path.suffix.lower() == ".docx":target_path = docx_folder / file_path.name# 若目标路径已存在，添加序号（如“报告_1.docx”）count = 1while target_path.exists():# 分离文件名和后缀：如“报告.docx” -> “报告”和“.docx”name = file_path.stemsuffix = file_path.suffix# 重命名目标路径：报告_1.docx、报告_2.docx...target_path = docx_folder / f"{name}_{count}{suffix}"count += 1# 后续移动逻辑不变...

自动化的本质是“把重复工作交给代码”——这个脚本虽然简单，但能帮你节省大量手动整理文件的时间，尤其适合经常处理文档的职场人、学生。如果你的工作中需要整理其他类型的文件（如表格、图片），也可以基于本文的扩展思路，修改脚本适配更多场景。

希望这个脚本能成为你的“效率小工具”，让你的文件夹从此井井有条！如果在使用中遇到新问题，或有更好的扩展想法，欢迎在评论区或者群里交流~