Czkawka 重复文件清理完整指南:14 种扫描十分钟清出几十 GB 空间
【免费下载链接】czkawkaMulti functional app to find duplicates, empty folders, similar images etc.项目地址: https://gitcode.com/GitHub_Trending/cz/czkawka
磁盘红了、相册塞不下新照片、旧目录翻不到想要的文件?Czkawka 是一款免费的开源重复文件清理工具,14 种扫描(重复文件、相似图片、相似视频、空文件夹等)全部在本地离线完成,扫一个资料目录通常只要几分钟,重复内容多时可以清出几十 GB。
重复文件清理工具是什么:一个 Rust 引擎,四个界面
整个项目用 Rust 编写(官方称几乎 100% 无 unsafe 代码),结构是"一核多壳":czkawka_core库承载全部扫描逻辑,上面接四个界面——桌面端 Krokiet(当前主推,Slint 框架)、czkawka_cli 命令行、安卓端 Cedinia(实验性)、老版 GTK 界面(12.0 起停止新功能)。依赖清单里没有任何网络、统计类库,扫描全程不联网、不收集数据;第二次扫同一批目录会直接命中哈希缓存,速度明显快于首次。
14 种工具按用途分三类:
- 查重类:重复文件(按文件名/大小/内容哈希三种方式)、相似图片、相似视频(抽帧 + 音频指纹两种模式)、相同音乐(标签比对 + 音频内容比对)
- 找杂类:空文件夹、空文件、临时文件、损坏文件、无效符号链接、扩展名与内容不匹配、坏文件名、大文件
- 维护类:EXIF 元数据清除、视频优化(裁剪静态边 + 转码为更高效的格式)
Krokiet 安装步骤:下载一个可执行文件
- 去官方发布页下载对应系统的预编译版,支持 Windows 10+、macOS 10.15+、Ubuntu 22.04+;它是单个自包含二进制,不用装运行时,也没有安装器;
- Linux 或 macOS 上先给执行权限再运行:
chmod +x mac_krokiet_arm64 && ./mac_krokiet_arm64前半句赋予执行权限,后半句启动程序;Windows 版直接双击 exe。
- macOS 首次打开若提示"无法验证开发者",右键文件选"打开"确认即可。
唯一的前置条件:相似视频和 EXIF 之外的视频优化需要 ffmpeg(sudo apt install ffmpeg,macOS 用 brew,Windows 可把 ffmpeg.exe 放到程序同目录),其余功能开箱即用。可选方案:老 GTK 界面和 Cedinia 都是独立安装包,新机器不必选;想从源码编译则克隆仓库后cargo build --release即可。
第一次扫描:从选目录到入回收站
以"重复文件"为例,六次点击跑完:
- 左侧面板点Duplicate Files;
- 要扫的位置加进Included Paths;系统目录、备份目录、网络磁盘放Excluded Paths——回收站已在默认排除列表里,不用手动加;
- 备份目录那行勾上Ref复选框,它就变成"只参考"路径:参与比对,但任何自动操作都不会删、移它;
- 设置里看最小文件大小,默认过滤约 8 KB(CLI 文档标注为 8192 字节)以下的文件,避免结果被零碎小文件淹没;
- 点扫描。默认就是内容哈希模式(BLAKE3,可换 XXH3、CRC32),逐字节比对内容,同名不同内容的文件不会进同一组;
- 结果按组展示,打开Select选"保留最新、选中其余",先移入回收站,确认无误再清空。
第二次扫同一批目录会快很多:哈希结果存在缓存里,且 Krokiet 默认开启预哈希缓存(只存大文件头尾 4 KB 的摘要),变更少的文件不用重新整读。
三个高频场景的参数调法
相似图片:阈值 10 起步原理是感知哈希:把图片压成一段短的"视觉指纹",指纹越接近判定越像。加过水印、裁过图、旋转过、JPEG 反复压缩的副本都能归进同一组。参数max difference默认 10:误判多就降到 4~5,漏报多再调高;勾上Geometric invariance后镜像、翻转的副本也能抓到。每组留分辨率最高的一张。
相似视频:抽帧对比,可切音频指纹视频没法逐字节比,Krokiet 从每段视频抽帧再比对画面;也可切到音频指纹模式只比声音不比画面,适合"同一首歌不同录屏"这类情况。两种模式都需要预装 ffmpeg。
音乐去重:标签快,内容准标签模式比艺术家、专辑、曲名,秒出结果;内容模式读音频比对波形,慢一些但能抓住改了标签的重复。曲库大就先跑标签模式清一遍,再对剩余分组跑内容模式。
czkawka_cli 定时清理:3 条命令加退出码
CLI 与图形界面共用同一套扫描逻辑:
czkawka_cli dup -d ~/Documents -D AEN -Q-D AEN是"保留最新、其余删除",-Q是演练模式:只打印会删什么,不动手。
czkawka_cli dup -d ~/Documents -D AEN -y确认后去掉-Q加-y,删的文件进回收站而不是直接永久删除。
czkawka_cli empty-folders -d ~/Documents -f empty.txt把空文件夹结果写入文本文件而不是打印到屏幕,方便喂给后续脚本。
脚本党关注退出码:11表示有发现,0表示干净,1是出错,正好接进计划任务的 if 判断。每个子命令都带--help可查全部参数。
新手常见误删场景
- 同名文件被归进同一组误删—— 用了按名字或按大小的匹配,同名不同内容也会被分一起;改回内容哈希(默认值)即可,名字/大小匹配只适合快速预筛。
- 小文件的重复找不到—— 默认跳过 8 KB 以下的小文件;到设置里把"最小文件大小"调低再扫。
- 建硬链接时报错—— 硬链接(一个文件挂多个名字,只占一份空间)只在同一磁盘内有效;跨盘场景改用移动操作。
- 一删就删多了—— 跳过了演练直接执行;先加
-Q看清单,确认后用回收站方式(-y)而不是永久删除。 - 系统盘、网盘也被扫了—— 扫描前没做排除;把系统目录、备份目录、网络磁盘先放进 Excluded Paths,又快又安全。
同类对比:Czkawka 对 DupeGuru
| 对比项 | Czkawka(Krokiet) | DupeGuru |
|---|---|---|
| 实现语言 | Rust,多线程扫描 | Python |
| 工具覆盖 | 14 类,含视频与音乐的内容级比对 | 以重复文件为主,另有相似图片、音乐标签 |
| 视频比对 | 支持(抽帧 + 音频指纹,需 ffmpeg) | 不支持 |
| 联网行为 | 完全离线,无更新检查与遥测 | 离线 |
| 维护状态 | 活跃开发 | 更新缓慢 |
下一步
- 总览与缓存、排除等术语说明:instructions/Instruction.md
- CLI 全部参数与自动化示例:instructions/Instruction_CLI.md
- 常见问题(空窗口、ffmpeg、最小文件大小等):instructions/FAQ.md
- 扫描逻辑源码:czkawka_core/src/
建议先拿下载目录扫一遍,确认删得放心、回收站里检查无误后,再把整个资料盘加进来。
【免费下载链接】czkawkaMulti functional app to find duplicates, empty folders, similar images etc.项目地址: https://gitcode.com/GitHub_Trending/cz/czkawka
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考