我要评论你是否经常面对这样的场景：下载的文档、工作报告、学习资料混在一个文件夹里，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 path
def 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 = 0
pdf_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.name
try:
shutil.move(str(file_path), str(target_path))
docx_count += 1
print(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.name
try:
shutil.move(str(file_path), str(target_path))
pdf_count += 1
print(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文件为例：
- 后缀判断：
file_path.suffix.lower() == ".docx"——suffix获取文件后缀（如.docx），lower()将后缀转为小写，确保.docx（大写）、.docx（混合大小写）也能被识别，兼容性更强。 - 目标路径拼接：
target_path = docx_folder / file_path.name——file_path.name获取文件名（如“报告.docx”），确保移动后文件名不变，用户容易找到。 - 文件移动：
shutil.move(str(file_path), str(target_path))——shutil.move是python标准库中用于“移动文件/目录”的函数，这里将path对象转为字符串（部分旧版本shutil对path支持不足，兼容处理）。 - 异常捕获：
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：运行脚本
打开“命令提示符”（win+r，输入cmd回车）。
运行脚本（假设脚本名为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.name
try:
shutil.move(str(file_path), str(target_path))
txt_count += 1
print(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.name
try:
shutil.move(str(file_path), str(target_path))
jpg_count += 1
print(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 = 1
while target_path.exists():
# 分离文件名和后缀：如“报告.docx” -> “报告”和“.docx”
name = file_path.stem
suffix = file_path.suffix
# 重命名目标路径：报告_1.docx、报告_2.docx...
target_path = docx_folder / f"{name}_{count}{suffix}"
count += 1
# 后续移动逻辑不变...
自动化的本质是“把重复工作交给代码”——这个脚本虽然简单，但能帮你节省大量手动整理文件的时间，尤其适合经常处理文档的职场人、学生。如果你的工作中需要整理其他类型的文件（如表格、图片），也可以基于本文的扩展思路，修改脚本适配更多场景。
到此这篇关于使用python进行一键整理文件,自动分类docx与pdf的文章就介绍到这了,更多相关python整理文件内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！
发表评论