dupeGuru 使用指南:十分钟完成第一次重复文件清理

本指南覆盖安装、界面认识、首次扫描、偏好设置与进阶技巧。内容基于 v4.3.1 稳定版整理,三个平台的操作方式保持一致。

第一步 · 安装

三平台安装要点

从下载中心获取 v4.3.1 安装包后,按对应平台的方式完成安装。

Windows

安装版:双击 dupeGuru_win64_4.3.1.exe 按向导完成安装。若 SmartScreen 弹出「Windows 已保护你的电脑」,点击「更多信息」-「仍要运行」即可(安装包未购买商业签名证书所致,属正常现象)。

便携版:将 ZIP 包完整解压到任意目录后运行 dupeguru.exe。请勿直接在压缩包内运行,否则设置无法保存。便携版不写注册表、无需管理员权限,也适合放在 U 盘随身使用。

macOS

解压 dupeguru_macOS_Qt_4.3.1.zip,将 dupeGuru.app 拖入「应用程序」文件夹。首次启动若被 Gatekeeper 拦截,前往「系统设置 - 隐私与安全性」点击「仍要打开」,或在应用程序上右键选择「打开」。

已安装 Homebrew 的用户也可以直接执行 brew install --cask dupeguru。Intel 与 Apple Silicon(M1)机型均受支持。

Linux

Debian / Ubuntu
sudo apt install ./dupeguru_4.3.1_amd64.deb
Fedora / RHEL
sudo dnf install ./dupeguru-4.3.1-2.x86_64.rpm

第二步 · 认识界面

主窗口四要素

dupeGuru 启动后直接进入主窗口,没有注册向导,也没有首次运行的复杂设置。

1应用模式选择器

窗口顶部的下拉菜单,用于切换「标准 / 图片 / 音乐」三种应用模式,决定扫描引擎使用的比对方式。

2文件夹面板

左侧的目录列表。每个目录可设置三种状态:普通(可扫描、可标记)、参考(受保护的原件)、排除(完全跳过)。

3扫描按钮

设置完成后点击「扫描」,引擎开始工作。扫描过程中可以查看实时进度。

4结果窗口

扫描结束后出现,按组列出重复文件。每组首行为参考文件(不可勾选删除),其余行为副本,附匹配度与文件信息。

第三步 · 首次扫描

五步完成一次完整的重复文件清理

以「清理杂乱的照片文件夹」为例,流程同样适用于文档、音乐或其他任何文件类型。

添加文件夹

点击「+」或直接拖放,把待清理目录加入列表。若有母版图库,将其设为「参考」,杂乱目录保持「普通」。

选择模式与类型

照片库选择「图片模式」;通用文件选择「标准模式 - 内容」获得零误报结果,或「文件名」捕捉改名副本。

执行扫描

点击「扫描」。引擎先按大小预分组、跳过唯一文件,再计算哈希,大型目录也能较快收敛。

审阅结果

逐组检查:参考文件不可删;副本的匹配度、大小、路径一目了然。双击可用默认程序打开确认。

标记并处理

勾选要清理的副本,在「操作」菜单选择「发送到回收站」。首次使用建议始终走回收站,确认无误再清空。

进阶设置

偏好设置详解

Windows / Linux 在「编辑 - 偏好设置」、macOS 在「dupeGuru - 偏好设置」中打开。以下是最值得了解的几项。

过滤硬度(Filter Hardness)

1–100 的滑杆,默认 80。它决定文件名扫描中两个名字需要多相似才会被判为重复:调低到 60–70 能捕捉更多改名副本(误报也会增多),调高到 90 以上则只匹配近乎一致的命名。内容扫描不受此设置影响。

音乐模式的标签扫描同样受这道门槛约束——标签里多一个版本后缀就可能被压到门槛之下,详见音乐模式扫不全的排查方法。

删除后清理空文件夹

开启后,删除或移动副本时产生的空目录会被自动移除,目录树保持整洁。

复制与移动行为

「直接置于目标目录」将副本平铺到目标位置;「重建相对路径」按扫描根的子结构摆放(推荐);「重建绝对路径」完整镜像原目录树。

自定义命令

可配置外部程序进行删除前的复核,占位符 %d 代表副本路径、%r 代表参考路径,适合接入 Beyond Compare、Meld 等比对工具。

效率工具

结果窗口常用快捷键

dupeGuru 结果窗口快捷键速查
快捷键 作用
空格切换当前选中文件的标记状态
Ctrl + A选中结果列表中的全部条目
Delete将选中条目从结果列表中移除(不删除磁盘文件)
双击文件使用系统默认程序打开该文件

macOS 上将 Ctrl 替换为 Command 即可。

进阶技巧

让清理工作更得心应手

重新确定参考

对整批结果按「大小 / 所在文件夹 / 文件名」等条件批量重设参考文件。例如始终保留位于「母版库」目录中的那一份,一键完成。

忽略列表与仅看副本

反复出现的误报文件对可加入「忽略列表」,后续扫描自动跳过;「仅显示副本」视图会隐藏参考文件,方便跨组按路径、大小排序,快速定位冗余最严重的目录。

Delta 值视图

开启后,文件大小与修改时间等字段将以相对差值显示(如 +0.2 MB、-0.5 MB),差异字段以橙色高亮,一眼分辨同组副本之间的质量差别。

先导出、后删除

处理重要数据前,先用「操作 - 导出结果」生成 CSV 或 HTML 报表留档,或在团队内共享评审,确认无误后再执行删除,形成可追溯的清理记录。

大库扫描建议面对数十万文件或数万张图片时:优先分批扫描子目录;图片模式耗时随图片数量快速增长,可先在单文件夹上试扫评估;扫描期间关闭其他内存占用大的程序。遇到异常可携带日志到 GitHub Issues 反馈,或查阅 官方帮助文档。

教程读完了,现在动手试试

下载 dupeGuru v4.3.1,用十分钟完成第一次安全清理。

再看看功能特性