Czkawka Windows 安装指南：3 步装好重复文件清理神器

Czkawka Windows 安装指南：3 步装好重复文件清理神器

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

Czkawka 是一款用 Rust 编写的开源磁盘清理工具，主打重复文件查找，同时覆盖空文件夹、相似图片、损坏文件、相似视频等 14 类扫描场景，且完全不联网、无任何遥测。在 Windows 上，官方推荐的图形界面是新一代前端Krokiet（Slint 框架，单个自包含 exe，解压即用），旧的 GTK 版 Czkawka 已停在 12.0 版不再更新。下面按"选对版本 → 装好 → 配依赖 → 避坑"的顺序，给你一条最省事的上手路径。

它能帮你清理什么：不止是重复文件

很多人只知道 Czkawka 能找重复文件，其实它内置的工具箱比这大得多（源码位于 czkawka_core/src/tools/）：

• 重复文件：按文件名、大小或哈希（默认 Blake3）三级递进判断，先按大小分组再算哈希，速度又快又不漏
• 空文件 / 空文件夹：批量揪出 0 字节文件和层层套娃的空目录
• 相似图片：感知哈希（Mean/Gradient 等多种算法）+ 可调相似度阈值，能认出不同分辨率、带水印的"同图"
• 相似视频：抽帧做视觉指纹比对，甚至支持按音频指纹找重复
• 大文件 / 临时文件：定位磁盘占用 Top N，清理下载目录里的残留
• 损坏文件：校验音视频、压缩包、字体、JSON/XML 等格式是否真的能打开
• 无效扩展名 / 异常文件名：文件内容跟后缀对不上（.txt 实为 .exe 这类坑）一键识别
• EXIF 清除 / 视频优化：抹掉照片隐私信息，把视频转成更省空间的编码

对新手最关键的一点：第二次扫描会明显变快。扫描引擎把哈希、时间戳等元数据写进缓存，重复扫同一个目录时只需处理新增和变化的文件。

下载前 30 秒自检：别选错 Windows 版本

项目里有三个前端容易混淆，先花 30 秒对号入座（详见 Krokiet 说明 与 FAQ）：

选 Krokiet 构建时的两个小细节：

1. on_linux还是on_windows：这是指 exe 在哪个系统上交叉编译出来的，普通用户两者都能跑，拿不准就先选on_linux。
2. 杀毒软件提前打预防针：Rust 开 LTO 优化的二进制在 Windows Defender 上偶尔会被误报为病毒。这是已知的误报现象，遇到拦截点"更多信息 → 仍要运行"，或对该文件添加排除项即可，不必换版本。

系统要求只有一条硬门槛：Windows 10 或更新，Windows 7 已不受支持。磁盘空间留 100MB 以上即可。

三步装好：从压缩包到第一次扫描

第 1 步：解压到一个固定目录

把下载好的压缩包解压到一个不会被清理软件挪走的位置，比如D:\Tools\krokiet。保持内部目录结构原样，不要把 exe 单拎出来丢到别处（GTK 版尤其如此，它依赖同目录下的配套文件）。

第 2 步：直接运行

双击krokiet.exe（或 GTK 版的czkawka_gui.exe）：

• 主窗口列出各个工具页签，能正常勾选扫描目录，说明装好了
• 若 GTK 版弹出黑窗或无法启动：不要直接双击 exe，改用压缩包里附带的.bat启动器（分别对应 cairo / opengl / vulkan 渲染器），cairo 是兼容性最好的保底选项
• 若 4K 屏上字特别小：这是 GTK 版的老毛病，可编辑%LocalAppData%\gtk-4.0\gtk.css加上* { font-size: 22px; }；Krokiet 则在设置里直接调缩放比例

第 3 步：跑一次小范围扫描

先选一个几十 GB 的目录（比如"下载"文件夹）体验流程：选工具 → 加目录 → 点 Search → 预览结果 → 选择并删除。确认顺手后，再考虑全盘扫描。删文件时建议用"移动到回收站"而非直接永久删除，首次使用务必先备份或在小目录试水。

FFmpeg 依赖怎么配（只有找相似视频才需要）

重复文件、相似图片这些核心功能不需要任何额外依赖。只有当你打算用"相似视频"工具时，才需要 FFmpeg 提供抽帧能力。三种配法任选其一：

1. 手动放文件：从 FFmpeg 官网下载 Windows 版，把ffmpeg.exe和ffprobe.exe拷到与程序 exe同一个目录，最省心
2. 加入 PATH：把ffmpeg.exe所在目录加进系统环境变量，然后重开终端（新会话才生效）
3. winget 一键装：在项目自带的 Windows 安装脚本 思路下执行winget install Gyan.FFmpeg，装完重启程序

配好后重启程序即可。顺带说明：HEIC/AVIF/RAW 这类高级图片格式在 Windows 预编译包里不可用（需要 MSYS2 版，见下一节），日常扫 JPG/PNG/WebP 完全不受影响。

进阶：MSYS2 版与命令行用法

想要更完整的 Windows 体验：MSYS2

如果你需要 HEIF、WebP 支持等完整功能，MSYS2 仓库里的包是目前 Windows 上功能最全的构建（Czkawka GUI 文档标注为社区维护）：

1. 安装 MSYS2 基础环境后，打开其终端
2. 装编译链：pacman -S mingw-w64-ucrt-x86_64-gcc
3. 装 GUI：pacman -S mingw-w64-x86_64-czkawka-gui
4. 程序位于C:\msys64\mingw64\bin\czkawka_gui.exe，可以直接加桌面快捷方式

命令行版：给自动化场景

czkawka_cli适合写进计划任务或批处理，几个高频参数（完整参数见 CLI 文档）：

:: 扫描 Downloads 找重复文件，只预览不删除 czkawka_cli.exe dup -d D:\Downloads --dry-run :: 真删：每组保留最新的一份，其余移入回收站 czkawka_cli.exe dup -d D:\Downloads -D AEN -y

注意 CLI不会自动套用界面版的默认排除规则（回收站、.git等），全盘扫描时要手动加：-E '$TRASH'跳过回收站，-E DEFAULT则套用界面版全套默认排除项。

便携版：把整个工具搬进 U 盘

Czkawka 支持通过两个环境变量把配置和缓存重定向到自定义位置（官方说明），配合启动脚本即可实现随 U 盘走：

set CZKAWKA_CONFIG_PATH=D:\czkawka\config set CZKAWKA_CACHE_PATH=D:\czkawka\cache krokiet.exe

把这两行写进一个run.bat放在 U 盘里，到哪台机器都能带上自己的配置和缓存。

配置与缓存放在哪：数据目录速查

默认位置（FAQ 速查表）：

几个实用结论：

• 缓存只存元数据（哈希、时间戳、大小），150TB 的量级也就几百 MB，不会吃爆磁盘
• 怀疑缓存坏了导致结果不对：直接删掉缓存目录，下次扫描自动重建（会慢一次）
• 扫描中删了大量文件后，用设置里的"移除过期缓存条目"手动清理，别开自动清理——尤其外接硬盘经常插拔时

踩坑急救：启动失败、扫不到、结果不对

程序启动后窗口是黑屏/透明的—— 多为 GPU 渲染器问题。Krokiet 可换all_backends构建里的其他渲染器，或在系统环境变量里设置SLINT_BACKEND=software强制软件渲染后重启；虚拟机无显卡时这是唯一解。

重复文件"明明有却找不到"—— 九成是最小文件大小在作祟：界面版默认忽略 16KB 以下的文件（小文件撞名是常态，官方刻意隐藏了这类噪音）。到设置里把最小尺寸调低即可；相似图片同理，另外检查"最大差异值"阈值是否过严。

扫描卡在某处、停止按钮没反应—— 遇到单个超大或难解码的文件时，单个任务不可中断，等它处理完就会恢复；重复文件查找等工具新版本已支持分块，可更快响应停止。

扫全盘时大量报"Permission denied"——.ssh、System Volume Information这类系统目录普通用户本就无权读，属正常日志，不影响结果；介意的话把它们加进排除项即可。

删不动/移不进回收站（网络盘、SMB/NFS 共享）—— 网络共享没有可用的回收站位置，改用"永久删除"按钮。

误把系统文件做了硬链接—— 硬链接后所有名字共享同一 inode，改一个全变。补救办法是逐个复制一份再覆盖回去；预防方法很简单：扫描前把C:\Windows、程序目录加进排除列表。

装好之后建议的进阶顺序：先用重复文件 + 空文件夹把空间收一轮，再上相似图片（阈值从 10 起步，误报多就调到 4~5），最后才是耗时的相似视频。语言切换在设置里直接改，中文等十余种语言都有支持。项目各版本的更新细节可查阅 Changelog.md。

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