企业官网建设流程全解析

Czkawka重复文件清理指南：4步完成第一次磁盘空间释放

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

下载文件夹里躺着截图.png、截图 (1).png、截图 - 副本.png，同一支 MP4 存了两个版本——这类重复文件清理工作，靠人工翻找几乎做不完。开源项目 Czkawka 就是为此设计的：一个用 Rust 编写、完全离线运行的多平台清理工具，重复文件、空文件夹、相似图片、相似视频都能扫。它不联网、无遥测，Windows 10 以上、macOS、Linux 均提供预编译版本。

一个核心库，四个前端

先弄清项目结构再选入口：真正的扫描逻辑都在czkawka_core这个 Rust 核心库里，上层只是不同壳子，功能彼此等价。

许可方面：核心库和 CLI 是 MIT；Krokiet、Cedinia 因链接 Slint 框架，整体应用遵循 GPL-3.0。

挑几个高频场景，说清什么时候该用

重复文件（hash 模式）——最常用的场景。原理上它不做逐字节比对，而是走三步：先按文件大小分组，再对文件头尾算一个快速的部分哈希（prehash）淘汰大部分无关文件，最后才对存疑文件算全量哈希。哈希你可以理解成文件的"指纹"，大小和指纹都相同才判定为重复。注意 Krokiet 默认忽略 16 KB 以下的小文件（避免满屏都是几十字节的相同配置文件），需要扫小文件时要在设置里调低。

相似图片——找"看起来一样"而非"字节一样"的图：不同分辨率的同一张图、加了水印的版本都能归到一组，靠的是感知哈希（把图像缩成小指纹再比对距离）。Krokiet 默认用 Mean 哈希、尺寸 16、最大差异 10，漏了就调大差异值，误报多了就调小或把哈希尺寸升到 32/64。

相似视频——原理是抽帧做视觉哈希再逐窗口比对，能认出同一素材的转码版本。这个工具依赖 ffmpeg 抽帧，不装就不可用，后面实操部分会讲。

空文件夹 / 大文件 / 临时文件——都是"扫一遍列出来"的轻量工具：前者顺带清理嵌套的空目录树，后者按指定数量列出最大的文件，适合快速定位空间都去哪儿了。

实操：从安装到删掉第一批重复文件

第 1 步：拿到 Krokiet 预编译包。从项目 Releases 页面按系统下载即可（Windows 选windows_krokiet_*，macOS 按 Intel/Apple Silicon 区分，Linux 要求 Ubuntu 22.04 及以上）。它是自包含的单文件程序，无运行时依赖，解压后直接运行，这也是官方主推它而非旧 GTK 版的原因。

第 2 步：只在要用相似视频时才装 ffmpeg。Windows 上执行winget install --id Gyan.FFmpeg -e --source winget（仓库里的 misc/install_scripts/install_windows.bat 脚本做的就是这一步），装完重启程序。

第 3 步：选目录时从小范围开始。首次扫描建议只勾下载、图片这类个人目录，别一上来就扫整块盘。Krokiet 的默认排除项已覆盖回收站、.git、node_modules等，扫描时它们不会被读；若报C:\System Volume Information拒绝访问属正常现象，程序会跳过继续扫。

第 4 步：确认后再删。结果按组展示，"全选除最新/最旧"这类自动选择模式每组必留一个文件，避免把某个内容的全份都删光；拿不准的组可以先用内置预览核对，再执行删除或移入回收站。

进阶两招：参考文件夹与缓存

参考文件夹解决"只删 A 目录里的重复，保住 B 目录里的原件"：把整理好的主相册/音乐库标为参考目录，普通目录照常加入扫描，结果里只有非参考目录的文件可被勾选删除。CLI 对应-r参数，多个参考目录要重复写多个-r。

缓存解释"为什么第二次扫描快"：程序把算过的哈希、修改时间存成缓存文件，文件没变就直接复用结果，Windows 下缓存在%LOCALAPPDATA%\Qarmin\Czkawka\cache\。删除大量文件后可以用设置里的"移除过时缓存结果"清一清。还有个实用技巧：设置环境变量CZKAWKA_CACHE_PATH和CZKAWKA_CONFIG_PATH可把数据挪到 U 盘，实现便携运行。

避坑笔记：常见报错按现象对号

现象：明显相同的小文件没被扫出来 → 原因：低于 16 KB 最小尺寸默认值 → 处理：Krokiet 在设置里调低最小文件尺寸，CLI 加--minimal-file-size。

现象：相似视频无结果或报错 → 原因：ffmpeg 不在 PATH 里 → 处理：装好 ffmpeg 后重开程序，或把ffmpeg.exe直接放进 Krokiet 可执行文件同目录（Windows 支持这种就近查找）。

现象：窗口全黑或白屏 → 原因：GPU 驱动与渲染后端不兼容 → 处理：用SLINT_BACKEND=software强制软件渲染启动，或换官方 all_backends 构建逐个试。

现象：杀毒软件把程序报成木马 → 原因：Rust 加 LTO 编译的已知误报 → 处理：核对官方发布的 SHA256 校验值后加白名单，别从第三方网站重新下载。

适合谁，从哪看起

它适合两类人：一是每周被下载目录和照片库困扰、想要"离线、免费、不装全家桶"清理方案的用户；二是想把扫描写进维护脚本、定期自动跑重复检查和空目录清理的工程师。更完整的参数说明、算法细节都在 instructions/ 目录，按 instructions/FAQ.md 或Instruction_Krokiet.md、Instruction_CLI.md查即可。想从源码构建的话，克隆仓库后执行cargo install krokiet --locked（仓库地址：https://gitcode.com/GitHub_Trending/cz/czkawka ），各工具的算法实现可按工具名在 czkawka_core/src/tools/ 下逐一对应。

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