入门指南
从下载到你的第一次重复扫描，全程不到五分钟。以下是开始清理磁盘所需的一切。
下载 Czkawka
前往下载版块获取最新版本（v12.0.2）。Czkawka 在 Windows 上以便携应用形式发布，无需安装程序。你将下载一个独立的 EXE（推荐，Krokiet 界面）或 ZIP（GTK 界面）。
应该选哪个版本？
- Krokiet（EXE） — 推荐使用的主力界面。基于 Slint，触摸友好，支持深色/浅色主题切换，单一可执行文件，无需解压，零依赖。
- Czkawka GTK（ZIP） — 基于 GTK4 的旧版界面。功能完整，但自 v12.0 起已停止维护。
- Czkawka CLI — 仅命令行，适合自动化、脚本或无头服务器。
新手请选择 Krokiet，通过标签式界面处理全部 14 种工具。
Linux 用户可跳过 EXE，用 Flatpak 安装（flatpak install flathub com.github.qarmin.czkawka）。macOS 可用 Homebrew（brew install czkawka）。Android 用户下载 Cedinia APK。
安装步骤
Czkawka 不使用传统安装程序，完全便携。无需注册表、无需系统修改、无需卸载流程。
Windows（Krokiet，推荐）
- 下载 windows_krokiet_on_windows_skia_opengl.exe。
- 放在任意位置，如 C:\Program Files\Czkawka。
- 双击 EXE 直接运行，无需解压。
Windows（GTK，旧版）
- 下载 windows_czkawka_gui_gtk_412.zip 并“全部解压”。
- 打开文件夹，双击 czkawka_gui.exe。不要删除 DLL 文件。
Windows SmartScreen 可能阻止首次启动。因无付费代码签名证书，Windows 会标记为无法识别。点击“更多信息” → “仍要运行”。应用安全，MIT 许可，源码公开可查。
Linux
flatpak run com.github.qarmin.czkawka
或下载 linux_krokiet_x86_64 二进制：
./linux_krokiet_x86_64
如需“相似视频”功能，请安装 ffmpeg。
macOS
./mac_krokiet_skia_vulkan_arm64
前往“系统设置 → 隐私与安全性”，点击“仍然允许”。
初始设置与配置
Czkawka 首次打开即用，无需注册、无首次运行向导。但大型扫描前建议调整几个设置。
左侧为扫描模式标签，顶部为目录配置区（包含目录 / 排除目录 / 项目配置）。
值得修改的设置
点击右下角齿轮打开设置面板：
- 将删除的文件移入回收站 — 开启它（默认关闭，删除是永久的）。
- 使用缓存 — 保持启用，跨会话保存哈希，重复扫描更快。
- 删除时显示确认对话框 — 保持勾选，防止误删。
- 语言 — 切换为你偏好的语言。
- 关闭时保存配置 — 保持启用。
从 dupeGuru 或 AllDup 迁移？工作流程类似：添加目录、选择模式、运行。Czkawka 借助 Rust 和 Blake3 哈希更快。
你的第一次重复扫描
添加要扫描的目录
- 确保顶部包含目录标签激活。
- 点击+ 添加，选择要扫描的文件夹。
- 勾选递归以包含所有子文件夹。
- 切换到排除目录标签，排除不想扫描的路径。
选择扫描方法
- 哈希 — 用 Blake3 逐字节比较，最准确。首次扫描推荐。
- 大小 — 仅按大小分组，极快但有误报。
- 名称 — 匹配相同文件名。
运行扫描
点击左下角绿色搜索按钮。500 GB 硬盘首次扫描约 2-5 分钟，缓存后显著加快。
审阅结果并操作
点击文件可高亮；点击重复图片右侧预览确认。使用底部按钮处理：
- 选择 — 智能选择（除最旧/最新外全部选择）。
- 删除 — 移除勾选文件（若开启则移入回收站）。
- 移动 — 移至指定文件夹而非删除。
- 符号链接 / 硬链接 — 用链接替换重复项。高级用户选项。
- 保存 — 导出结果到文本文件。
小心系统文件夹。永远不要扫描 C:\Windows 或 /usr 并删除文件。坚持使用个人文件夹。
技巧、窍门与最佳实践
使用参考文件夹保护重要目录
在包含目录面板中，可将任意文件夹标记为参考文件夹。其中的文件永不被选中删除，只有其他目录的重复项会被标记。
使用相似图片清理照片
切换到相似图片标签，查找看起来相同但尺寸/分辨率不同的照片。可调整相似度阈值。
加速重复扫描
缓存跨会话存储文件哈希。重复扫描仅需重新哈希新增/修改的文件。
要避免的常见错误
- 不要不排除系统文件夹就扫描整个 C: 盘。
- 不要删除分组中的所有副本 — 始终保留至少一份。
- 避免多实例同时扫描 — Czkawka 内部已多线程。
命令行用法
运行 czkawka_cli --help 查看可用命令。典型终端重复扫描：
命令行还支持 image、big、empty、video、music、broken 等子命令，对应全部 14 种工具。
在哪里获得帮助
Czkawka 在 GitHub 上积极开发。提交 bug 报告和功能请求到 Issues。社区活跃于 r/DataHoarder、r/linux。