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)

相关推荐
星依网络10 分钟前
yolov5实现游戏图像识别与后续辅助功能
python·开源·游戏程序·骨骼绑定
大佐不会说日语~29 分钟前
Spring AI Alibaba 的 ChatClient 工具注册与 Function Calling 实践
人工智能·spring boot·python·spring·封装·spring ai
2501_9216494939 分钟前
如何获取美股实时行情:Python 量化交易指南
开发语言·后端·python·websocket·金融
qq_4480111644 分钟前
python HTTP请求同时返回为JSON的异常处理
python·http·json
棒棒的皮皮1 小时前
【OpenCV】Python图像处理几何变换之翻转
图像处理·python·opencv·计算机视觉
CodeCraft Studio1 小时前
国产化PPT处理控件Spire.Presentation教程:使用Python将图片批量转换为PPT
python·opencv·powerpoint·ppt文档开发·ppt组件库·ppt api
五阿哥永琪2 小时前
Spring Boot 中自定义线程池的正确使用姿势:定义、注入与最佳实践
spring boot·后端·python
Data_agent2 小时前
Python编程实战:从类与对象到设计优雅
爬虫·python
Swizard2 小时前
别再迷信“准确率”了!一文读懂 AI 图像分割的黄金标尺 —— Dice 系数
python·算法·训练
超级大只老咪2 小时前
数组的正向存储VS反向存储(Java)
java·开发语言·python