前言:为硬盘减负
你是否也有这样的烦恼:手机或相机的存储卡满了,里面的照片和视频成千上万,堆在一个文件夹里杂乱无章?想把它们备份到移动硬盘,却发现手动按日期分类太累?备份完了又不敢轻易删除源文件,怕万一没拷过去怎么办?
C:\pythoncode\new\media_backup_tool.py
今天,我们将利用 Python 和 wxPython 图形界面库,编写一个自动化的工具。它不仅能按拍摄日期自动归档媒体文件,还能在校验成功后安全地将源文件移入回收站。
- 核心功能与技术栈
我们要实现的功能非常明确:
GUI 界面:通过日历选择日期,通过文件选择器选择源目录和目标目录。
按日期筛选:自动扫描源文件夹(包括子目录),找出指定日期创建的照片/视频。
自动归档:在目标盘建立 YYYYMMDD 格式的文件夹,并复制文件。
安全清理:复制成功且校验无误后,将源文件移入回收站(而不是直接永久删除)。
防假死:使用多线程处理文件操作,防止界面卡顿。
使用的库:
wxPython: 绘制原生风格的图形界面。
shutil: 负责文件的高级复制(保留元数据)。
os & datetime: 处理文件路径和时间。
send2trash: 关键库,用于将文件发送到回收站。
threading: 实现后台任务处理。
- 代码深度剖析
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 编程的金科玉律。
- 运行效果
程序启动后,只需三步:
选择你要整理的那一天的日期(例如某次旅游的日期)。
选择存放混乱照片的源文件夹。
选择移动硬盘作为目标文件夹。
点击"开始",你会在日志框看到一行行滚动的记录:
10:00:01\] 成功备份并清理: IMG_2023.JPG \[10:00:02\] 发现重名,重命名为: VIDEO_001_1.MP4 完成后,程序目录还会生成一个 backup_history.txt,记录你的备份流水。 ### 运行结果   