Python实战:手把手教你写一个带界面的“照片按日期归档与清理”工具

前言:为硬盘减负

你是否也有这样的烦恼:手机或相机的存储卡满了,里面的照片和视频成千上万,堆在一个文件夹里杂乱无章?想把它们备份到移动硬盘,却发现手动按日期分类太累?备份完了又不敢轻易删除源文件,怕万一没拷过去怎么办?

C:\pythoncode\new\media_backup_tool.py

今天,我们将利用 Python 和 wxPython 图形界面库,编写一个自动化的工具。它不仅能按拍摄日期自动归档媒体文件,还能在校验成功后安全地将源文件移入回收站。

  1. 核心功能与技术栈

我们要实现的功能非常明确:

GUI 界面:通过日历选择日期,通过文件选择器选择源目录和目标目录。

按日期筛选:自动扫描源文件夹(包括子目录),找出指定日期创建的照片/视频。

自动归档:在目标盘建立 YYYYMMDD 格式的文件夹,并复制文件。

安全清理:复制成功且校验无误后,将源文件移入回收站(而不是直接永久删除)。

防假死:使用多线程处理文件操作,防止界面卡顿。

使用的库:

wxPython: 绘制原生风格的图形界面。

shutil: 负责文件的高级复制(保留元数据)。

os & datetime: 处理文件路径和时间。

send2trash: 关键库,用于将文件发送到回收站。

threading: 实现后台任务处理。

  1. 代码深度剖析
    2.1 界面布局 (GUI Layout)

我们继承了 wx.Frame 来创建主窗口。布局上使用了 wx.BoxSizer,这是一种弹性盒子布局,能够让界面元素随窗口大小自动调整。

code

Python

download

content_copy

expand_less

核心控件初始化

self.date_picker = wx.adv.DatePickerCtrl(panel, style=wx.adv.DP_DROPDOWN | wx.adv.DP_SHOWCENTURY)

self.src_picker = wx.DirPickerCtrl(panel, message="选择源文件夹")

self.dst_picker = wx.DirPickerCtrl(panel, path=default_path, message="选择目标文件夹")

亮点:使用了 DatePickerCtrl,让用户点选日历,而不是手动输入"2023-11-25",减少了格式错误的可能。

2.2 遇到的"坑":wx.DateTime 类型转换

在编写过程中,我们遇到了一个典型的报错:

TypeError: unsupported operand type(s) for +: 'sip.enumtype' and 'int'

原因分析:

wxPython 的较新版本(Phoenix)中,wx_date.Month 属性返回的是一个枚举对象(如 wx.DateTime.Month.Jan),而不是整数。且 wxPython 的月份是从 0 开始(0-11),而 Python 标准库 datetime 需要的是 1-12。

解决方案:

我们必须使用 .GetMonth() 方法获取整数值,并手动 +1。

code

Python

download

content_copy

expand_less

修正后的代码

wx_date = self.date_picker.GetValue()

GetMonth() 返回 0-11,所以需要 +1

target_date = datetime.date(wx_date.GetYear(), wx_date.GetMonth() + 1, wx_date.GetDay())

2.3 核心逻辑:遍历与筛选

为了找到深藏在子文件夹里的照片,我们使用了 os.walk()。它可以递归地遍历目录树。

code

Python

download

content_copy

expand_less

MEDIA_EXTENSIONS = {'.jpg', '.mp4', ...} # 定义白名单

for root, dirs, files in os.walk(src_dir):

for file in files:

1. 扩展名过滤

if ext.lower() not in MEDIA_EXTENSIONS: continue

复制代码
    # 2. 日期匹配
    ctime = os.path.getctime(file_path)
    file_date = datetime.date.fromtimestamp(ctime)
    
    if file_date == target_date:
        self.ProcessFile(...)

这里的逻辑非常严谨:只处理白名单内的媒体文件,避免误移动系统文件或文本文件。

2.4 数据安全:复制与"后悔药"机制

这是本工具最核心的价值所在。普通脚本用 shutil.move,一旦出错文件可能丢失。我们采用了"复制+校验+放入回收站"的三步走策略。

code

Python

download

content_copy

expand_less

def ProcessFile(self, src_path, dst_folder, filename):

... 省略重名处理 ...

复制代码
# 第一步:复制 (copy2 保留拍摄时间等元数据)
shutil.copy2(src_path, dst_path) 

# 第二步:校验
# 确保目标文件存在,且大小与源文件一致
if os.path.exists(dst_path) and os.path.getsize(dst_path) == os.path.getsize(src_path):
    # 第三步:安全删除 (放入回收站)
    send2trash(src_path)
else:
    self.Log("错误:复制校验失败,未删除源文件")

使用 send2trash 是为了给用户一剂"后悔药"。万一你选错了日期或者程序逻辑有误,文件只是在回收站里,随时可以还原,数据安全大于一切。

2.5 用户体验:多线程防假死

如果直接在按钮点击事件里运行上述循环,处理几百个视频时,界面会直接卡死(显示"未响应")。为了解决这个问题,我们引入了 threading。

code

Python

download

content_copy

expand_less

def OnStartBackup(self, event):

禁用按钮

self.btn_start.Disable()

开启子线程

thread = threading.Thread(target=self.RunBackupLogic, args=(...))

thread.start()

def Log(self, message):

使用 wx.CallAfter 确保在主线程更新 UI,防止崩溃

wx.CallAfter(self.log_ctrl.AppendText, f"...{message}\n")

注意:子线程不能直接操作界面控件(如 TextCtrl),必须使用 wx.CallAfter 将更新指令发送回主UI线程,这是 GUI 编程的金科玉律。

  1. 运行效果

程序启动后,只需三步:

选择你要整理的那一天的日期(例如某次旅游的日期)。

选择存放混乱照片的源文件夹。

选择移动硬盘作为目标文件夹。

点击"开始",你会在日志框看到一行行滚动的记录:

10:00:01\] 成功备份并清理: IMG_2023.JPG \[10:00:02\] 发现重名,重命名为: VIDEO_001_1.MP4 完成后,程序目录还会生成一个 backup_history.txt,记录你的备份流水。 ### 运行结果 ![在这里插入图片描述](https://i-blog.csdnimg.cn/direct/23225fa65fe54a48bfb2bb56005934bf.png) ![在这里插入图片描述](https://i-blog.csdnimg.cn/direct/dad717934a084969a4ddd5ddcd3d9946.png) ![在这里插入图片描述](https://i-blog.csdnimg.cn/direct/0022bdfe331348ba990b401f1bc5e1e5.png)

相关推荐
程序员三藏4 小时前
Jmeter自动化测试
自动化测试·软件测试·python·测试工具·jmeter·测试用例·接口测试
吴佳浩6 小时前
Langchain 浅出
python·langchain·llm
smj2302_796826526 小时前
解决leetcode第3753题范围内总波动值II
python·算法·leetcode
mortimer6 小时前
破局视频翻译【最后一公里】––从语音克隆到口型对齐的完整工程思路
python·github·aigc
门框研究员9 小时前
解锁Python的强大能力:深入理解描述符
python
子不语18010 小时前
Python——函数
开发语言·python
daidaidaiyu10 小时前
一文入门 LangChain 开发
python·ai
JJ1M811 小时前
用 Python 快速搭建一个支持 HTTPS、CORS 和断点续传的文件服务器
服务器·python·https
汤姆yu11 小时前
基于python大数据的小说数据可视化及预测系统
大数据·python·信息可视化