【亲测免费】 dupeGuru 安装和配置指南

dupeGuru 安装和配置指南

1. 项目基础介绍和主要的编程语言

dupeGuru 是一个跨平台的图形化工具，用于在系统中查找重复文件。它支持 Linux、macOS 和 Windows 操作系统。dupeGuru 主要使用 Python 3 编写，并使用 Qt 框架来构建用户界面。

2. 项目使用的关键技术和框架

• 编程语言: Python 3
• 用户界面框架: Qt（使用 PyQt）
• 构建工具: Makefile、pip、virtualenv
• 包管理: setuptools、debhelper（用于生成 Debian/Ubuntu 包）
• 测试工具: Tox

3. 项目安装和配置的准备工作和详细的安装步骤

3.1 准备工作

在开始安装之前，请确保您的系统已经安装了以下软件：

• Python 3.7+: dupeGuru 需要 Python 3.7 或更高版本。
• PyQt5: 用于构建用户界面。
• pip: Python 包管理工具。
• virtualenv: 用于创建隔离的 Python 环境（可选，但推荐）。

3.2 安装步骤

3.2.1 克隆项目仓库

首先，从 GitHub 克隆 dupeGuru 的代码仓库：

git clone https://github.com/arsenetar/dupeguru.git
cd dupeguru

3.2.2 创建虚拟环境（可选）

为了隔离 dupeGuru 的依赖环境，建议创建一个虚拟环境：

python3 -m venv env
source env/bin/activate  # 在 Windows 上使用 `env\Scripts\activate`

3.2.3 安装依赖

在虚拟环境中安装所需的 Python 包：

pip install -r requirements.txt

3.2.4 构建和运行 dupeGuru

dupeGuru 提供了一个 Makefile，可以使用以下命令进行构建和运行：

make && make run

如果您不想使用 Makefile，也可以手动运行以下命令：

python build.py
python run.py

3.2.5 生成 Debian/Ubuntu 包（可选）

如果您想生成 Debian/Ubuntu 包，请确保安装了额外的依赖：

pip install -r requirements-extra.txt

然后运行以下命令生成包：

python build.py --clean
python package.py

3.3 运行测试

dupeGuru 使用 Tox 来运行测试。如果您已经安装了 Tox，可以直接在项目根目录下运行：

tox

如果没有安装 Tox，可以在虚拟环境中安装并运行：

pip install tox
tox

4. 总结

通过以上步骤，您应该能够成功安装和配置 dupeGuru，并开始使用它来查找系统中的重复文件。如果您在安装过程中遇到任何问题，可以参考项目的 GitHub 页面或社区论坛获取帮助。