Krokiet 完全上手指南：免费离线找出重复文件、空文件夹与相似图片，从安装到扫出第一批重复

【免费下载链接】czkawkaMulti functional app to find duplicates, empty folders, similar images etc.项目地址: https://gitcode.com/GitHub_Trending/cz/czkawka

Czkawka 项目当前推荐的前端 Krokiet 是一款免费、开源、完全离线的磁盘清理工具：它不联网、不收集任何使用数据，内置重复文件、空文件夹、相似图片等 14 个扫描工具。本文以 Windows 为主线，讲清从下载、解压、启动到装好 FFmpeg、验证安装可用的完整路径，Linux 和 macOS 的差别也会点到，照着做完你就能扫出磁盘里的第一批重复。

Krokiet 是什么：一个引擎，三个前端

Czkawka 的扫描逻辑全部写在 czkawka_core 里，上面有三个前端：

• Krokiet：基于 Slint 的新版图形界面，静态链接、不依赖任何外部运行时，Windows / macOS / Linux 都能直接跑，是当前唯一在持续迭代的前端；
• Czkawka GTK：旧版 GTK4 界面，12.0 是它的最后一个发布版，官方不再提供新二进制，Windows 和 macOS 上还有透明窗口、高分屏文字发糊等难以根治的问题；
• czkawka_cli：命令行版，适合写脚本和自动化，用法见 czkawka_cli/README.md。

新人记住一条就够了：装 Krokiet。新功能和所有修复都只在这里发生。另外它没有任何网络代码路径——不信可以翻 Cargo.lock，依赖里没有reqwest、hyper、curl这类网络库。

该下哪个包：看懂版本号命名

发布包命名大致是<os>_<app>[_<特性>][_<后端>]_<架构>，几个常见片段：

• krokiet：图形版本体；cli：命令行版；
• x86_64/arm64：CPU 架构，大多数 Windows 和 Linux 机器选x86_64；
• heif/raw/avif：额外图片格式支持，需要系统里装对应的库（libheif / libraw / libavif），用不到就选默认版；
• skia_opengl/skia_vulkan/femtovg_wgpu/all_backends：备用渲染后端，只有默认版字体发糊、渲染失败或崩溃时才需要；
• on_linux/on_windows（仅 Windows）：.exe的交叉编译宿主，拿不准时先选windows_krokiet_on_linux。

装之前：系统和空间两件事

Krokiet 的包是单文件自包含二进制，不装任何运行时、不需要编译器，解压即用。

Windows 安装三步：下载、解压、双击

第 1 步：下载预构建包。打开项目的发布页，选带krokiet字样的 Windows 包（Windows 是 zip 压缩包）。认准 Krokiet，别下gtk_gui的包——那个 12.0 之后就不更新了。

第 2 步：解压到固定目录。整个 zip 解到一个位置（C:\Tools\、用户目录都行），保持内部结构不拆散。不要单独移动包里的文件、不要改名，程序找不到依赖时会直接开不起来。

第 3 步：双击krokiet.exe。主界面会列出重复文件、空文件、空文件夹、相似图片等全部工具，左侧就是工具列表。

一个风险提醒：Rust 的 LTO 编译产物容易触发 Windows Defender 误报（FAQ 里有专门章节）。如果 Defender 拦截，点「更多信息 → 仍要运行」，或核对发布页的 SHA256 与 CI 产物一致后再放行。

Linux / macOS 的差异只有一点点：Linux 下下载linux_krokiet_x86_64（或_arm64），执行chmod +x后直接运行；macOS 下选mac_krokiet_arm64（Apple Silicon）或mac_krokiet_x86_64，同样先chmod +x。macOS 首次提示「无法打开，因为来自身份不明的开发者」时，右键文件选「打开」并确认即可。

什么时候必须装 FFmpeg：只有两个工具要它

FFmpeg 是视频抽帧工具，Krokiet 不自带。程序启动相关工具时会执行ffmpeg -version和ffprobe -version检查环境（逻辑在 czkawka_core/src/common/ffmpeg_utils.rs），两个命令都成功才认为可用。

• 谁需要它：Similar Videos（抽帧做视觉哈希）、Same Music 的内容对比，以及 Video Optimizer 的转码/裁剪。只用重复文件、空文件夹、相似图片的话，装不装无所谓。
• 装在哪：最省事的办法是把ffmpeg.exe和ffprobe.exe放到与krokiet.exe同一个目录；或者把 FFmpeg 的bin目录加进系统 PATH（改完 PATH 要开新终端或重启才生效）。
• 放错会怎样：不是全盘罢工，而是视频/音乐类工具报「找不到 ffmpeg」，其余工具照常工作。

Windows 下可以直接用winget install Gyan.FFmpeg，或者跑仓库里现成的 misc/install_scripts/install_windows.bat；Linux 用sudo apt install ffmpeg，macOS 用brew install ffmpeg。想同时支持 HEIF/RAW/AVIF 图片，则选带heif_raw_avif的构建并安装对应系统库（instructions/FAQ.md 有各平台清单）。

装完之后，用这张清单验证

• 双击krokiet.exe后主界面正常渲染，左侧能看到重复文件、空文件、空文件夹、大文件、相似图片等 14 个工具
• 挑一个几百 MB 的小测试目录跑「重复文件」扫描，结果按组显示、每组至少两个文件
• %APPDATA%\Qarmin\Krokiet\config\下已自动生成config_general.json和config_preset_N.json（N 为 0-10，共 11 个预设槽）
• 设置里能切换界面语言，改动会写回上面的配置文件
• 用到相似视频时，ffmpeg.exe、ffprobe.exe在krokiet.exe同目录或 PATH 中，且命令行跑ffmpeg -version有输出

缓存目录注意一下，它和配置不在一起：Windows 在%LOCALAPPDATA%\Qarmin\Czkawka\cache\，Linux 在~/.cache/czkawka/。这个缓存被 Krokiet、GTK、CLI 三个前端共享，二次扫描会直接命中它，明显比首扫快。

出问题先对照这张表

扫起来之后的几条经验

1. 先小范围后全盘。拿一个 Downloads 之类的目录熟悉每个工具的行为，再对整个C:\下手。默认排除项已覆盖回收站（Windows 下为*:\$RECYCLE.BIN\*）和.git、node_modules等目录，自己清空过排除项的话记得加回来。
2. 用 Reference Folder 保护原文件。把整理好的主收藏目录标为参考文件夹，只把下载目录当普通扫描路径：扫描结果里只有非参考目录的文件能被勾选删除，误删风险直接归零。CLI 对应-r参数，多个参考目录要重复传多次。
3. 删重复前先过一遍「选择」模式。「除最新外全选」这类自动选择每组合必留至少一个文件，但手动全选后删除前程序也会再警告一次——看到警告别直接确认。
4. 迁移电脑时带走两个目录。配置（%APPDATA%\Qarmin\Krokiet\config\）和缓存（%LOCALAPPDATA%\Qarmin\Czkawka\cache\）就是全部状态；更彻底的做法是设置环境变量CZKAWKA_CONFIG_PATH和CZKAWKA_CACHE_PATH，把两者指到 U 盘，实现便携模式，对所有前端生效。
5. 同一工具别开两个实例。不同工具可以并行（各自用独立缓存文件），但同一工具开两份会写坏它的缓存。
6. 高分屏上 GTK 版文字小？那是旧前端的老问题；Krokiet 自带缩放设置，这也是建议直接迁到 Krokiet 的理由之一。

延伸阅读

• krokiet/README.md：Krokiet 完整用法与编译说明
• instructions/FAQ.md：数百个真实用户问题整理成的 FAQ，含各工具参数调优
• instructions/Instruction_Krokiet.md：Krokiet GUI 逐项功能讲解
• czkawka_cli/README.md：命令行版，适合自动化批量清理
• 扫描引擎源码：czkawka_core/src/tools/

【免费下载链接】czkawkaMulti functional app to find duplicates, empty folders, similar images etc.项目地址: https://gitcode.com/GitHub_Trending/cz/czkawka