常见问题 FAQ

非常快。基于 Rust + 多线程 + BLAKE3 哈希 + 预哈希机制 + 智能缓存，性能远超 Python 编写的同类工具。

根据公开第三方基准测试：37.92GB 代码库查重仅需 4 秒（dupeGuru 需 63 秒）；1TB NAS 冷扫描 85 秒（dupeGuru 需 142 秒）；13GB 设计文件 1 秒。首次扫描后，第二次及后续扫描因缓存机制会显著加快，部分场景可达首次的 1/5 耗时。

Czkawka 支持非常广泛的文件格式，涵盖几乎所有常见的存储类型：

图片：jpg/jpeg/png/bmp/tiff/gif/webp/ico/exr/avif/heic/heif/jxl 等（RAW/HEIF/AVIF 需自编译启用对应 feature）

视频：mp4/mkv/webm/flv/avi/mov 等（相似视频与视频优化器需 ffmpeg）

音频：mp3/flac/wav/ogg/m4a/aac 等

文档：PDF

压缩包：zip/7z/gz/tar/zst/bz2/xz

字体：ttf/otf/ttc

标记文件：JSON/XML/TOML/YAML/SVG

内存占用极低。由于使用 Rust 编写，无 Python 解释器和 GC 开销，内存占用远低于 dupeGuru、FSlint 等 Python 工具。在 100 万文件级别的大型扫描中，Czkawka 的内存占用通常只有同类工具的 1/3 到 1/5。

CPU 使用：感知哈希、视频解码、BLAKE3 计算等阶段会全核占用，这是正常现象。如需限制，可通过 CLI -T 数字 或 GUI 设置中调整线程数。磁盘 I/O 是主要瓶颈，建议扫描机械硬盘时控制并发数避免磁头频繁寻道。

这是 Rust + LTO（链接时优化）编译二进制的已知误报现象。由于 LTO 会深度内联和优化代码，生成的二进制特征模式偶尔会被启发式杀毒引擎误判。

所有发布文件均由公开的 GitHub Actions 从开源代码构建，SHA256 校验值与 CI 产物一致，可在 VirusTotal 核实（多数引擎判定为干净）。Windows Defender 提示时选择"更多信息 → 仍要运行"即可。

如果您仍然担心，可以选择从源码自行编译：克隆仓库后执行 cargo build --release --bin krokiet，整个过程透明可审计。

相似视频查找和视频优化器需要单独安装 ffmpeg 并将其加入系统 PATH 环境变量。Czkawka 本身不内置 ffmpeg，以保持二进制的轻量与跨平台一致性。

各平台安装方式：

Linux：sudo apt install ffmpeg（Debian/Ubuntu）、sudo dnf install ffmpeg（Fedora）、sudo pacman -S ffmpeg（Arch）

macOS：brew install ffmpeg

Windows：winget install Gyan.FFmpeg，或从 ffmpeg.org 下载并手动加入 PATH

安装完成后用 ffmpeg -version 验证。重启 Czkawka 后相似视频功能即可正常使用。

两者共享同一核心引擎 czkawka_core，主要区别在 GUI 框架：

Krokiet：基于 Slint 框架的新一代 GUI，静态编译、自包含、跨平台稳定，作者推荐所有平台使用。当前正在积极开发。

Czkawka GTK：基于 GTK4 的旧版 GUI，v12.0 后停止维护。在 Windows 和 macOS 上有渲染问题，Linux 上仍可使用但不推荐新用户。

czkawka_cli：纯命令行版本，无 GUI 依赖，适合服务器、CI/CD、脚本自动化。

官方建议：所有新用户直接使用 Krokiet。老 GTK 版用户建议迁移至 Krokiet 以获得更好的体验和持续更新。

手机：无法直接扫描通过 MTP 连接的手机（MTP 协议限制）。解决方案有两个：① 安装 Cedinia（Android 实验版）直接在手机上扫描；② 将手机文件复制到电脑本地后扫描。

NAS / 网络共享：完全支持。Windows 下用"手动添加"输入 UNC 路径（如 \\nas\photos），或先映射为盘符；Linux/macOS 下挂载 SMB/NFS 共享到本地路径后扫描。

注意：在 NFS/SMB 网络共享上，"移至回收站"功能可能失败（取决于共享配置），建议改用"永久删除"或先将文件移到本地处理。扫描网络存储速度受网络带宽限制。

可以导出，但暂不支持重新导入 GUI。所有工具都支持将扫描结果导出为文本文件或 JSON 文件，便于外部查看、归档或脚本处理。

CLI 通过 -f 文件名 参数导出：czkawka_cli dup -d /data -f report.json

GUI 中点击"File → Save Results"选择格式保存。JSON 格式结构清晰，包含文件路径、大小、哈希、分组等完整信息，便于程序化分析。

注意：当前版本不支持将导出的文件重新导入 GUI 恢复交互式结果视图。如需重新查看，需要重新扫描（但因缓存机制，速度会很快）。

可以同时运行不同工具，但不能同时运行同一工具的两个实例。原因：同一工具的多个实例会同时读写相同的缓存文件，导致缓存损坏或数据竞争。

例如，您可以同时打开一个"重复文件查找"实例和一个"相似图片查找"实例，因为它们使用独立的缓存文件。但不要同时打开两个"重复文件查找"实例。

如果确实需要并行处理多个目录的重复文件，建议使用 CLI 串行执行多个扫描任务，或为不同实例配置不同的 CZKAWKA_CACHE_PATH 环境变量（便携模式）。

本站（www.czkawka.cn）是 Czkawka 的中文介绍与推广站，致力于为中文用户提供本地化的产品介绍、使用教程和下载指引。

Czkawka 的官方源代码托管于 GitHub：github.com/qarmin/czkawka。所有下载链接均指向 GitHub 官方 Releases，本站不提供任何修改版的二进制文件。

本站内容由本站团队基于公开资料整理撰写，不代表官方立场。如需报告软件 Bug、提交功能建议，请直接在 GitHub Issues 提交。