一、环境准备与依赖安装
在开始编写档案整理脚本之前，需要确保本地计算机已经安装了Python运行环境。本指南基于Python 3.x版本开发，利用其内置的标准库os和shutil即可完成所有文件操作，无需安装复杂的第三方库。
1. 安装Python环境
如果尚未安装Python，请直接访问Python官方下载页面：https://www.python.org/downloads/。下载对应操作系统的安装包，安装时务必勾选"Add Python to PATH"选项，以便在命令行中直接调用。
2. 验证安装状态
打开终端（Windows下为CMD或PowerShell，Mac/Linux下为Terminal），输入以下命令检查环境是否配置成功：
```bash
python --version
```
如果终端返回了版本号（例如Python 3.9.7），说明环境已就绪。如果提示“找不到命令”，请重新检查安装步骤或手动配置环境变量。
二、档案整理策略与逻辑设计
为了实现通用的档案整理，我们将设计一套基于“文件类型”和“时间戳”的双重归档逻辑。脚本将执行以下核心动作：
- 扫描源目录：读取指定文件夹下的所有文件。
- 识别文件类型：根据文件后缀名判断归属（如图片、文档、压缩包等）。
- 生成归档路径：在目标目录下按照“文件类型/年份/月份”的结构创建文件夹。
- 移动文件：将源文件移动到计算出的归档路径中，处理重名冲突。
三、完整脚本代码实现
新建一个文本文件，将其重命名为archive_organizer.py。将以下完整代码复制粘贴到文件中。该代码包含详细的中文注释，解释了每一行的作用。
```python
import os
import shutil
import datetime
import time
================= 配置区域 =================
设置需要整理的源文件夹路径（请修改为你的实际路径）
注意：Windows路径建议使用 r"" 原始字符串，避免转义问题
SOURCE_DIR = r"C:\Users\YourName\Downloads\MessyFolder"
设置整理后的目标文件夹路径
TARGET_DIR = r"C:\Users\YourName\Documents\ArchivedFiles"
定义文件分类规则（扩展名 -> 分类文件夹名称）
FILE_TYPES = {
'图片': ['.jpg', '.jpeg', '.png', '.gif', '.bmp', '.svg', '.webp', '.heic'],
'文档': ['.pdf', '.doc', '.docx', '.txt', '.xls', '.xlsx', '.ppt', '.pptx', '.csv'],
'音频': ['.mp3', '.wav', '.flac', '.aac', '.ogg'],
'视频': ['.mp4', '.avi', '.mkv', '.mov', '.wmv', '.flv'],
'压缩包': ['.zip', '.rar', '.7z', '.tar', '.gz'],
'代码': ['.py', '.js', '.html', '.css', '.java', '.cpp', '.json', '.xml']
}
===========================================
def get_file_category(filename):
"""根据文件扩展名获取分类名称"""
ext = os.path.splitext(filename)[1].lower()
for category, extensions in FILE_TYPES.items():
if ext in extensions:
return category
return '其他'
def get_file_datetime(filepath):
"""获取文件的最后修改时间"""
timestamp = os.path.getmtime(filepath)
return datetime.datetime.fromtimestamp(timestamp)
def organize_files():
检查源目录是否存在
if not os.path.exists(SOURCE_DIR):
print(f"错误：源目录 {SOURCE_DIR} 不存在，请检查配置。")
return
统计计数器
count = 0
print(f"开始整理目录：{SOURCE_DIR}")
遍历源目录下的所有文件
for filename in os.listdir(SOURCE_DIR):
source_path = os.path.join(SOURCE_DIR, filename)
跳过目录，只处理文件
if not os.path.isfile(source_path):
continue
1. 获取分类
category = get_file_category(filename)
2. 获取时间信息
file_dt = get_file_datetime(source_path)
year = file_dt.strftime('%Y')
month = file_dt.strftime('%m')
3. 构建目标目录结构：TARGET_DIR/分类/年份/月份
target_folder = os.path.join(TARGET_DIR, category, year, month)
4. 创建目标目录（如果不存在）
if not os.path.exists(target_folder):
try:
os.makedirs(target_folder)
print(f"创建目录：{target_folder}")
except OSError as e:
print(f"创建目录失败：{e}")
continue
5. 处理目标文件路径（防止重名覆盖）
target_path = os.path.join(target_folder, filename)
如果文件已存在，则在文件名后加时间戳
if os.path.exists(target_path):
name, ext = os.path.splitext(filename)
timestamp_suffix = int(time.time())
new_filename = f"{name}_{timestamp_suffix}{ext}"
target_path = os.path.join(target_folder, new_filename)
print(f"检测到重名，重命名为：{new_filename}")
6. 移动文件
try:
shutil.move(source_path, target_path)
print(f"已移动：{filename} -> {target_folder}")
count += 1
except Exception as e:
print(f"移动文件 {filename} 失败：{e}")
print("-" 30)
print(f"整理完成！共处理 {count} 个文件。")
if __name__ == "__main__":
organize_files()
```
四、代码核心逻辑详解
为了确保读者能根据自身需求修改脚本，以下对代码中的关键模块进行详细拆解。
1. 配置区域修改
脚本顶部的SOURCE_DIR和TARGET_DIR是必须修改的参数。请将C:\Users\YourName\Downloads\MessyFolder替换为你电脑上实际需要整理的混乱文件夹路径。目标路径可以设定为一个新建的空文件夹。
FILE_TYPES字典定义了分类规则。如果需要支持新的文件格式（例如.psd设计文件），只需在对应的列表中添加字符串即可：
```python
'图片': ['.jpg', '.psd'], 添加了 .psd 格式
```
2. 目录创建逻辑 (os.makedirs)
代码使用了os.makedirs(target_folder)。与普通的mkdir不同，makedirs具有递归功能。如果目标路径是D:/Archived/图片/2023/10，而磁盘中只有D:/Archived，该函数会自动创建中间缺失的“图片”和“2023”文件夹，不会报错。
3. 文件移动与重名处理
直接使用shutil.move可能会覆盖目标文件夹中同名的重要文件。本脚本通过os.path.exists(target_path)进行了预判。如果发现冲突，会利用time.time()获取当前Unix时间戳，将其附加到文件名后（例如report_1698765432.pdf），确保数据安全。
五、部署与执行步骤
完成代码编写后，按照以下步骤运行脚本，即可实现一键归档。
步骤1：保存脚本文件
确保上述代码已保存为UTF-8编码的.py文件，放置在任意非中文路径下（例如D盘根目录），以防止编码报错。
步骤2：打开命令行工具
在文件夹资源管理器中，按住Shift键并右键点击脚本所在的空白处，选择“在此处打开PowerShell窗口”或“在此处打开命令提示符”。
步骤3：执行脚本
在命令行中输入以下命令并回车：
```bash
python archive_organizer.py
```
步骤4：观察执行结果
终端会实时滚动显示正在创建的目录和移动的文件。如果看到“整理完成！”的提示，说明所有操作已成功结束。此时打开TARGET_DIR配置的目标文件夹，即可看到按层级分类整理好的档案。
六、常见报错处理方案
在实操过程中，可能会遇到以下两类常见问题，请参考对应的解决方案。
1. 权限不足错误 (PermissionError)
如果提示“PermissionError: [Errno 13] Permission denied”，通常是因为源文件正在被其他程序打开（例如Word文档正在编辑中），或者目标文件夹需要管理员权限才能写入。请关闭相关文件后重试，或以管理员身份运行命令行。
2. 文件路径包含中文乱码
虽然Python 3对中文支持良好，但在Windows CMD中有时仍会出现编码问题。建议在代码第一行添加以下声明，并确保脚本文件保存格式为UTF-8：
```python
-- coding: utf-8 --
```
通过以上步骤，你已成功构建了一套零成本的自动化档案整理系统。该脚本不仅适用于个人电脑的下载文件夹清理，也可用于服务器日志文件的定期归档，具有极高的复用价值。
