Windows
安装版:双击 dupeGuru_win64_4.3.1.exe 按向导完成安装。若 SmartScreen 弹出「Windows 已保护你的电脑」,点击「更多信息」-「仍要运行」即可(安装包未购买商业签名证书所致,属正常现象)。
便携版:将 ZIP 包完整解压到任意目录后运行 dupeguru.exe。请勿直接在压缩包内运行,否则设置无法保存。便携版不写注册表、无需管理员权限,也适合放在 U 盘随身使用。
本指南覆盖安装、界面认识、首次扫描、偏好设置与进阶技巧。内容基于 v4.3.1 稳定版整理,三个平台的操作方式保持一致。
安装版:双击 dupeGuru_win64_4.3.1.exe 按向导完成安装。若 SmartScreen 弹出「Windows 已保护你的电脑」,点击「更多信息」-「仍要运行」即可(安装包未购买商业签名证书所致,属正常现象)。
便携版:将 ZIP 包完整解压到任意目录后运行 dupeguru.exe。请勿直接在压缩包内运行,否则设置无法保存。便携版不写注册表、无需管理员权限,也适合放在 U 盘随身使用。
解压 dupeguru_macOS_Qt_4.3.1.zip,将 dupeGuru.app 拖入「应用程序」文件夹。首次启动若被 Gatekeeper 拦截,前往「系统设置 - 隐私与安全性」点击「仍要打开」,或在应用程序上右键选择「打开」。
已安装 Homebrew 的用户也可以直接执行 brew install --cask dupeguru。Intel 与 Apple Silicon(M1)机型均受支持。
sudo apt install ./dupeguru_4.3.1_amd64.deb
sudo dnf install ./dupeguru-4.3.1-2.x86_64.rpm
第二步 · 认识界面
dupeGuru 启动后直接进入主窗口,没有注册向导,也没有首次运行的复杂设置。
窗口顶部的下拉菜单,用于切换「标准 / 图片 / 音乐」三种应用模式,决定扫描引擎使用的比对方式。
左侧的目录列表。每个目录可设置三种状态:普通(可扫描、可标记)、参考(受保护的原件)、排除(完全跳过)。
设置完成后点击「扫描」,引擎开始工作。扫描过程中可以查看实时进度。
扫描结束后出现,按组列出重复文件。每组首行为参考文件(不可勾选删除),其余行为副本,附匹配度与文件信息。
第三步 · 首次扫描
以「清理杂乱的照片文件夹」为例,流程同样适用于文档、音乐或其他任何文件类型。
点击「+」或直接拖放,把待清理目录加入列表。若有母版图库,将其设为「参考」,杂乱目录保持「普通」。
照片库选择「图片模式」;通用文件选择「标准模式 - 内容」获得零误报结果,或「文件名」捕捉改名副本。
点击「扫描」。引擎先按大小预分组、跳过唯一文件,再计算哈希,大型目录也能较快收敛。
逐组检查:参考文件不可删;副本的匹配度、大小、路径一目了然。双击可用默认程序打开确认。
勾选要清理的副本,在「操作」菜单选择「发送到回收站」。首次使用建议始终走回收站,确认无误再清空。
进阶设置
Windows / Linux 在「编辑 - 偏好设置」、macOS 在「dupeGuru - 偏好设置」中打开。以下是最值得了解的几项。
1–100 的滑杆,默认 80。它决定文件名扫描中两个名字需要多相似才会被判为重复:调低到 60–70 能捕捉更多改名副本(误报也会增多),调高到 90 以上则只匹配近乎一致的命名。内容扫描不受此设置影响。
音乐模式的标签扫描同样受这道门槛约束——标签里多一个版本后缀就可能被压到门槛之下,详见音乐模式扫不全的排查方法。
开启后,删除或移动副本时产生的空目录会被自动移除,目录树保持整洁。
「直接置于目标目录」将副本平铺到目标位置;「重建相对路径」按扫描根的子结构摆放(推荐);「重建绝对路径」完整镜像原目录树。
可配置外部程序进行删除前的复核,占位符 %d 代表副本路径、%r 代表参考路径,适合接入 Beyond Compare、Meld 等比对工具。
效率工具
| 快捷键 | 作用 |
|---|---|
| 空格 | 切换当前选中文件的标记状态 |
| Ctrl + A | 选中结果列表中的全部条目 |
| Delete | 将选中条目从结果列表中移除(不删除磁盘文件) |
| 双击文件 | 使用系统默认程序打开该文件 |
macOS 上将 Ctrl 替换为 Command 即可。
进阶技巧
对整批结果按「大小 / 所在文件夹 / 文件名」等条件批量重设参考文件。例如始终保留位于「母版库」目录中的那一份,一键完成。
反复出现的误报文件对可加入「忽略列表」,后续扫描自动跳过;「仅显示副本」视图会隐藏参考文件,方便跨组按路径、大小排序,快速定位冗余最严重的目录。
开启后,文件大小与修改时间等字段将以相对差值显示(如 +0.2 MB、-0.5 MB),差异字段以橙色高亮,一眼分辨同组副本之间的质量差别。
处理重要数据前,先用「操作 - 导出结果」生成 CSV 或 HTML 报表留档,或在团队内共享评审,确认无误后再执行删除,形成可追溯的清理记录。
大库扫描建议面对数十万文件或数万张图片时:优先分批扫描子目录;图片模式耗时随图片数量快速增长,可先在单文件夹上试扫评估;扫描期间关闭其他内存占用大的程序。遇到异常可携带日志到 GitHub Issues 反馈,或查阅 官方帮助文档。
全平台安装包(Windows / macOS / Linux)· v4.3.1

夸克网盘App扫码 · 识别 使用夸克网盘 App 扫描二维码获取安装包

百度网盘App扫码 · 识别 使用百度网盘 App 扫描二维码获取安装包
安装包同步自 GitHub 官方发布渠道,亦可前往 GitHub Releases 直接下载。