Czkawka 重复文件清理快速上手从下载到第一次扫出结果【免费下载链接】czkawkaMulti functional app to find duplicates, empty folders, similar images etc.项目地址: https://gitcode.com/GitHub_Trending/cz/czkawkaCzkawka 是一款用 Rust 写的开源磁盘清理工具核心能力是重复文件清理同时覆盖相似图片、相似视频、空文件夹、大文件等共 14 种扫描场景。它完全免费、离线运行不联网、不收遥测扫描和删除都发生在本地。仓库里有一个核心库加多个前端装之前先花 30 秒分清自己要哪个能省掉后面大部分困惑。先分清要装的是哪个前端全部扫描逻辑都在 czkawka_core/ 里上层是几个互不相干的前端前端状态适合谁KrokietSlint 界面活跃开发跨 Windows/macOS/Linux绝大多数人czkawka_cli 命令行版活跃开发要写脚本、跑定时任务的人czkawka_gui GTK 版12.0 之后不再出新版本已装的可继续用新装不建议注意发行版源AUR、Debian 等里的包多为第三方维护的 GTK 旧版落后官方好几个版本。新装用户直接下官方 Releases 里的预编译包。三种获取方式按情况选预编译二进制推荐去仓库 Releases 页面命名规则是系统_程序[_特性]_架构比如linux_krokiet_x86_64、mac_krokiet_arm64。Windows 用户拿windows_krokiet_on_linux_x86_64基本不会错。Linux/macOS 下载后chmod x再运行。cargo 一行安装需先装 Rust 工具链cargo install krokiet --locked源码编译git clone https://gitcode.com/GitHub_Trending/cz/czkawka cd czkawka cargo build --release --bin krokiet编译 Krokiet 不需要 GTK 或任何图形库这是它取代 GTK 版的主要原因。只有要支持 HEIC/AVIF/RAW 时才需装libheif/libavif/libraw并加--features heif,libavif,libraw日常照片视频用不到。唯一必装的外部依赖是 ffmpeg且只有相似视频这一个工具需要它系统安装方式Linuxsudo apt install ffmpegmacOSbrew install ffmpegWindowswinget install Gyan.FFmpeg或把ffmpeg.exe放到和主程序同一目录第一次运行从启动到第一份重复文件报告以 Krokiet 为例CLI 等价命令放在每步旁边启动后左侧面板选Duplicate Files重复文件默认工具。点Add把要扫的目录加入 Included paths。要保护某个备份目录就勾它旁边的Ref复选框参考路径——参考路径里的文件只参与比对永远不会被删除。点Scan。结果按组显示粗体行是组头下面列出组内文件。用Select弹窗选策略比如 All except newest保留最新然后点Trash进回收站而不是直接 Delete。第一次用建议全程走回收站。命令行等价流程czkawka_cli dup -d /home/user/Documents # 只看结果 czkawka_cli dup -d /home/user/Documents -D AEN -Q # 演练保留最新预览会删什么 czkawka_cli dup -d /home/user/Documents -D AEN -y # 确认后执行移入回收站两个新手最容易踩的点最小文件大小默认 16 KB更小的文件不参与比对。这是故意的——全盘扫描时几 KB 的小文件碰巧相同的概率很高全列出来只会淹没真正的大重复。要扫小文件就去 Settings 把 File size 下限调低。GUI 默认已排除回收站和系统目录*:\$RECYCLE.BIN\*、*/Trash/*等CLI 不享受这个默认值扫全盘时自己加-E DEFAULT或-E $TRASH。引号别省否则 shell 会把它当变量展开。重复文件的核心比对逻辑在 czkawka_core/src/tools/duplicate/core.rs对实现感兴趣可以直接翻。日常使用缓存、预哈希和排除规则Krokiet 的扫描结果不是每次从头算的三个机制叠起来第二次扫同一批文件能快几倍哈希缓存算过的文件哈希存成缓存文件下次直接读且 Krokiet/GTK/CLI 三个前端共享。位置Linux~/.cache/czkawka/macOS~/Library/Caches/pl.Qarmin.Czkawka/Windows%LOCALAPPDATA%\Qarmin\Czkawka\cache\。预哈希Krokiet 默认开启只读文件首尾各 4KB 算部分哈希大部分不重复的文件在这一步就被排除不用整文件读一遍。中断不算白干扫描可以中途停已算出的哈希已经落盘下次扫描接着受益。窗口大小、语言、主题等配置存在~/.config/krokiet/和缓存是分开的两套文件。想把整套东西挪到 U 盘做便携版设两个环境变量即可三个前端都认CZKAWKA_CONFIG_PATH/media/usb/czkawka/config \ CZKAWKA_CACHE_PATH/media/usb/czkawka/cache \ ./krokiet排除规则建议固化*/.git、*/node_modules、*/tmp*这类通配模式放 Excluded items比逐个目录加 Excluded paths 灵活。建议不要同时开两个实例扫同一个工具缓存文件会被并发写坏。不同工具各开一个没问题。相似图片的阈值调到多少合适重复文件是内容完全一致相似图片是看着像但字节不同——分辨率变了、压过两次、带水印都能匹配。原理是把图缩成感知哈希再比距离参数都围着指纹转。GUI 默认组合算法 Mean、哈希尺寸 16、最大差异 10。按这个起点调漏了明显相似的图Max difference 往上调如 15要抓镜像和旋转 90 度的拷贝开 Geometric invariance 到mirror-flip-rotate90代价是明显变慢。误报多不相关的图归一堆Max difference 降到 4~5同时 Hash size 升到 32 或 64指纹更长就不容易撞车。CLI 对应参数是-s最大差异注意 CLI 默认只有 5比 GUI 严和-c哈希尺寸。一条完整的扫描命令czkawka_cli image -d /home/user/Photos \ -E $TRASH \ -s 10 -c 16 -g Gradient \ --geometric-invariance mirror-flip-rotate90 \ -f similar_results.txt$TRASH宏的用法见前面第一次运行一节。算法实现在 czkawka_core/src/tools/similar_images/core.rs。命令行自动化删除策略代码和退出码-D参数控制每组重复文件留谁删谁作用于 dup/image/video/music 四个工具代码效果AEN保留最新的删其余AEO保留最旧的删其余AEB / AES保留最大 / 最小删其余ON / OO / OB / OS只保留最新 / 最旧 / 最大 / 最小HARD把重复项替换成硬链接跨分区会报错原文件不动NONE默认只出结果退出码是接脚本的关键0没扫到东西11扫到了1出错。所以CI 里出现空文件就失败这种需求不用写任何解析逻辑czkawka_cli empty-files -d ./build_output -N -M # 退出码 11 存在空文件脚本据此退出结果输出三种格式可叠加-f纯文本给人看-C压缩 JSON、-p缩进 JSON 给脚本解析。保护原件、清理下载目录是典型场景czkawka_cli dup \ -d /home/user/Downloads \ -r /home/user/Archive \ -D AEN -y-r指定参考目录Archive 里的文件只比对、不参与删除。多个参考目录要重复-r传逗号隔开不生效。出问题怎么办黑窗、误报和缓存异常按出现频率排序窗口全黑/空白Linux 多见GPU 渲染后端和驱动不兼容。先强制软件渲染SLINT_BACKENDsoftware ./krokiet虚拟机、无头服务器上这基本是唯一可行方案。想试其他后端下all_backends包里面每个渲染器配了一个.sh启动脚本跑通哪个用哪个。Windows Defender 报毒Rust LTO 编译产物的常见误报。核对文件哈希确认干净后在 Defender 里放行或加排除。Permission denied (os error 13)扫到.ssh之类无权限目录的正常提示程序记一条日志就继续。嫌吵就加进排除列表。第二次扫描变慢或结果怪异缓存坏了。删掉~/.cache/czkawka/下对应的缓存文件如cache_duplicates_*.bin下次扫描重建。缓存只存元数据150TB 量级的扫描也才几百 MB不用担心撑爆磁盘。扫描卡在 99%、Stop 无反应正在处理单个超大文件程序只能在一个文件处理完之后再响应中断。这是行为不是死机等它走完。注意相似视频的缓存按处理参数扫描时长、窗口数等区分文件改过这些参数后相当于从零开始属预期行为。我自己用这类工具的习惯是先拿一个 100GB 左右的目录把 Select 策略、Trash、缓存位置走一遍再放大到全盘。工具再稳删文件这件事也得先练手。【免费下载链接】czkawkaMulti functional app to find duplicates, empty folders, similar images etc.项目地址: https://gitcode.com/GitHub_Trending/cz/czkawka创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考