WindowsCleaner：让C盘重获新生的清理神器安装指南

快速概览

WindowsCleaner是一款专为Windows系统打造的开源清理工具，专治C盘爆红、系统卡顿等症状。通过直观的图形界面，你可以轻松释放磁盘空间，让系统运行如飞。本指南将带你从0到1完成安装配置，无论是直接运行还是本地编译，都能找到适合自己的方案。

准备工作

在开始安装前，请确保你的系统满足以下条件：

• 操作系统：Windows 10 或 Windows 11（64位系统最佳）
• Python环境：Python 3.8（推荐此版本以确保兼容性）
• 硬件要求：至少100MB空闲磁盘空间

为什么选择Python 3.8？因为该项目的依赖库在Python 3.8环境下经过充分测试，使用更高版本可能会遇到兼容性问题。

必装工具

1. Git：用于克隆项目代码仓库
2. Python 3.8：项目运行的基础环境
3. pip：Python包管理工具（通常随Python一起安装）

获取项目代码

步骤1：克隆代码仓库

打开命令提示符（CMD）或PowerShell，执行以下命令获取项目源码：

git clone https://gitcode.com/gh_mirrors/wi/WindowsCleaner

如果没有安装Git，也可以直接访问仓库页面下载ZIP压缩包并解压。

步骤2：进入项目目录

cd WindowsCleaner

直接运行方式（推荐新手）

如果你只是想快速体验WindowsCleaner的功能，直接运行Python脚本是最简单的方式。

步骤1：创建虚拟环境（可选但推荐）

python -m venv venv
venv\Scripts\activate

为什么需要虚拟环境？它可以隔离项目依赖，避免与系统中其他Python项目产生冲突。

步骤2：安装依赖包

pip install -r requirements.txt

这个命令会安装所有必要的依赖库，包括PyQt5图形界面框架等核心组件。

步骤3：启动应用程序

python main.py

成功运行后，你将看到WindowsCleaner的主界面，如下图所示：

本地编译方式（适合高级用户）

如果你希望获得更好的性能，或者想将程序分享给没有Python环境的朋友，可以选择本地编译成可执行文件。

步骤1：安装编译工具

pip install nuitka

Nuitka是一个将Python代码编译为C语言可执行文件的工具，比传统的打包工具性能更好。

步骤2：执行编译命令

python -m nuitka --standalone --remove-output --output-dir=dist --windows-console-mode="disable" --enable-plugins="pyqt5" --main=main.py --windows-icon-from-ico=icon.ico

编译过程可能需要几分钟时间，取决于你的电脑性能。编译完成后，可执行文件会生成在dist目录下。

直接运行 vs 本地编译对比

特性	直接运行	本地编译
启动速度	中等	较快
依赖需求	需要Python环境	无额外依赖
可移植性	低	高
更新便捷性	高（直接拉取代码）	低（需重新编译）
性能	中等	较高

制作安装包（进阶操作）

如果你想制作一个可以分发给他人的安装程序，可以使用Inno Setup工具：

步骤1：安装Inno Setup

从官方网站下载并安装Inno Setup编译器。

步骤2：编译安装包

1. 启动Inno Setup
2. 打开项目根目录下的script.iss文件
3. 点击工具栏上的"编译"按钮
4. 等待编译完成，安装程序会生成在releases目录下

目录结构解析

安装完成后，了解项目目录结构有助于更好地使用和定制工具：

WindowsCleaner/
├── main.py          # 程序入口文件
├── requirements.txt # 项目依赖列表
├── script.iss       # Inno Setup安装脚本
├── WCMain/          # 核心功能模块
│   ├── AppDataCleaner.exe # 应用数据清理工具
│   └── SpaceSniffer.exe   # 磁盘空间分析工具
├── readme/          # 文档和图片资源
└── Lang/            # 语言文件

常见问题解决

Q: 运行python main.py时提示缺少模块？

A: 确保已激活虚拟环境（如果创建了的话），并重新执行pip install -r requirements.txt

Q: 编译时报错怎么办？

A: 检查是否安装了Visual Studio及msvc编译器，这是Nuitka编译所必需的。

Q: 程序界面显示乱码？

A: 这可能是字体问题，可以尝试修改settings.json文件中的字体设置。

开始使用

安装完成后，启动WindowsCleaner，你将看到以下主要功能区域：

1. 一键清理：快速扫描并清理系统垃圾
2. 高级清理：自定义清理规则和目标
3. 空间分析：通过SpaceSniffer可视化磁盘使用情况
4. 设置中心：自定义清理偏好和界面主题

选择你需要的功能，点击对应按钮即可开始使用。定期使用WindowsCleaner，可以让你的系统保持最佳状态！

建议每周运行一次全面清理，特别是在系统更新后或安装大型软件后。

免责声明

在使用本C盘清理工具之前，请仔细阅读以下免责声明。使用本工具即表示您同意并接受以下所有条款和条件：

1. 风险自担：使用本工具清理C盘可能会导致数据丢失、系统不稳定或其他不可预见的问题。用户应自行承担使用本工具的风险。
2. 备份数据：在使用本工具之前，请确保您已备份重要数据。本工具开发者不对因使用本工具而导致的数据丢失或损坏负责。
3. 适用性：本工具仅适用于Windows操作系统的C盘清理。对于其他操作系统或磁盘分区，本工具可能不适用或无法正常工作。
4. 第三方软件：本工具可能会扫描和清理第三方软件产生的临时文件和垃圾文件。但本工具不对第三方软件的兼容性或稳定性负责。
5. 系统要求：使用本工具前，请确保您的计算机满足最低系统要求，并且已安装必要的更新和补丁。
6. 法律责任：本工具开发者不对因使用本工具而违反任何法律法规或侵犯任何第三方权益的行为负责。
7. 终止使用：如果您不同意本免责声明的任何条款，请立即停止使用本工具。

使用本工具即表示您已理解并同意上述免责声明。如果您对本免责声明有任何疑问，请联系本工具开发者。

通过本指南，你已经掌握了WindowsCleaner的各种安装方式和基本使用方法。无论是普通用户还是高级开发者，都能找到适合自己的使用方案。现在，让我们开始清理C盘，给系统来一次彻底的"大扫除"吧！