📋 准备工作：了解你的选择

WxCleaner 提供两种使用方式，对比如下：

特性 方式一：直接运行 (推荐) 方式二：源码运行
适用人群 所有用户，特别是非开发者 开发者，或想自定义代码的用户
前置要求 无需任何环境 需要 Python 3.8+ 及系统依赖
操作复杂度 极简，下载即用 中等，需要执行命令
获取文件 从项目 Releases 页面下载 .exe 文件 克隆 GitHub 仓库

🚀 方式一：直接运行 Windows 可执行文件（最简单）

这是给普通用户最方便的方法，无需安装 Python。

  1. 下载文件：
    • 访问项目的 Releases 页面（通常在 GitHub 仓库右侧边栏）。
    • 下载最新版本的 WxCleaner.exe 文件。
  2. 运行程序：
    • 找到下载的 WxCleaner.exe 文件，双击即可直接运行。

🛠️ 方式二：从源码运行（跨平台）

此方法适用于 Windows、macOS 和 Linux，适合开发者或想从源码启动的用户。

第 1 步：环境准备 (安装 Python 和 Tkinter)

  1. 安装 Python：确保你的系统已安装 Python 3.8 或更高版本。在终端输入 python --version 或 python3 --version 检查。

  2. 安装 Tkinter (重要)：WxCleaner 的图形界面依赖 tkinter。部分系统需要单独安装：

    • macOS (Homebrew):

      1
      brew install python-tk

    • Ubuntu / Debian:

      1
      sudo apt-get install python3-tk

    • Fedora / RHEL:

      1
      sudo dnf install python3-tkinter

    • Arch Linux:

      1
      sudo pacman -S tk

第 2 步：获取代码与安装依赖

  1. 克隆仓库：在终端中执行以下命令，将项目代码下载到本地。

    1
    2
    git clone https://github.com/yqxie1991/WxCleaner.git
    cd WxCleaner

  2. 创建虚拟环境 (推荐)：隔离项目环境，避免依赖冲突。

    1
    2
    3
    4
    5
    6
    7
    8
    # 创建虚拟环境
    python -m venv venv

    # 激活虚拟环境
    # Windows:
    venv\Scripts\activate
    # macOS / Linux:
    source venv/bin/activate

  3. 安装 Python 依赖：在激活的虚拟环境中，安装项目所需的库。

    1
    pip install -r requirements.txt

第 3 步：启动程序

在项目根目录下，确保虚拟环境已激活，运行以下命令：

1
python main.py

📖 使用指南：如何清理重复文件

无论用哪种方式启动，程序界面操作都是一致的：

  1. 选择路径：
    • 程序会尝试自动识别并填入你电脑上微信的默认文件目录。
    • 你也可以点击 “浏览” 按钮，手动选择其他文件夹（如微信自定义的存储路径）。
  2. 开始扫描：
    • 点击 “开始扫描” 按钮。程序会快速分析所选目录下的所有文件，并显示实时进度。
  3. 查看与标记结果：
    • 扫描完成后，列表会清晰展示所有重复的文件组。
    • 颜色提示：列表中，红色高亮的是建议删除的冗余副本，绿色的是将被保留的文件。
    • 辅助操作：你可以点击表头（如“大小”、“修改时间”）进行排序，或右键点击任意文件，选择在系统文件管理器中打开位置进行确认。
  4. 执行清理：
    • 勾选你想要删除的文件（可以点击 “全选重复项” 快速选择所有建议删除的副本）。
    • 确认无误后，点击 “移至回收站” 按钮。
    • 在二次确认弹窗中点击确认，文件就会被安全地移动到系统回收站/废纸篓，方便你反悔恢复。

🧑‍💻 开发者专属：自行打包 EXE 文件

如果你想自己生成一个单文件的 WxCleaner.exe：

  1. 确保已安装 pyinstaller：

    1
    pip install pyinstaller

  2. 在项目根目录下执行打包命令：

    1
    pyinstaller WxCleaner.spec

  3. 打包完成后，生成的 .exe 文件会位于 dist/ 文件夹内。

⚠️ 重要提醒与免责

  • 数据安全：工具使用 send2trash 库，所有删除操作都是“移至回收站”，并非永久删除，极大降低了误删风险。
  • 操作建议：尽管有安全机制，在执行批量清理前，仍强烈建议你手动浏览并确认列表中文件的内容和重要性，避免误删重要数据。
  • 责任声明：根据项目免责声明，因误操作或第三方软件冲突导致的任何数据丢失，作者不承担责任。

🔗 附：项目资源链接