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,记录你的备份流水。

运行结果



相关推荐
用户956256254298 小时前
跟做:Firecrawl 单页转 Markdown 再丢进沙箱总结
python·api
威哥爱编程8 小时前
模拟面试智能体开发实战 02:回答等半分钟,谁还愿意练?把服务端和流式输出搭起来
python·agent·harmonyos
威哥爱编程9 小时前
模拟面试智能体开发实战 01:面试挂了都不知道挂在哪?用 Python 给自己造一个随叫随到的 AI 面试官
python·agent·harmonyos
2601_967980119 小时前
Python行情API量化 02:顺序拉 20 要 2 秒?并发批量把时间压到 0.5 秒
python·api·限流·并发·量化
伞伞悦读9 小时前
【第81期】特征缩放怎么选:标准化、MinMax 与 Robust 的原理、泄漏对照和完整实验
人工智能·python·深度学习·机器学习
新*10 小时前
从一段 WebSocket 代码聊开:bytes 不是 zlib、binaryType 决定一切,15MB 大消息的零拷贝优化
javascript·python·websocket·性能优化·blob·zlib·arraybuffer
卷无止境12 小时前
mathmodel-figure-templates 以及两个上手案例
后端·python
锋行天下12 小时前
服务器 Python 2.7 装不了 langgraph-cli?用本地生成 Dockerfile 曲线救国
人工智能·后端·python
一条大祥脚12 小时前
深入理解 PyTorch FlexAttention:从 Score Mod 到 Mask Mod 的稀疏加速之道
人工智能·pytorch·python·注意力机制·flex attention·可编程注意力
2601_9679801113 小时前
Python自动化办公:模块、库与样式调整教程
python·excel·自动化办公·openpyxl·样式调整