WindowsCleaner：让C盘重获新生的清理神器安装指南
项目地址: https://gitcode.com/gh_mirrors/wi/WindowsCleaner 快速概览
WindowsCleaner是一款专为Windows系统打造的开源清理工具，专治C盘爆红、系统卡顿等症状。通过直观的图形界面，你可以轻松释放磁盘空间，让系统运行如飞。本指南将带你从0到1完成安装配置，无论是直接运行还是本地编译，都能找到适合自己的方案。
准备工作
在开始安装前，请确保你的系统满足以下条件：
- 操作系统：Windows 10 或 Windows 11（64位系统最佳）
- Python环境：Python 3.8（推荐此版本以确保兼容性）
- 硬件要求：至少100MB空闲磁盘空间
为什么选择Python 3.8？因为该项目的依赖库在Python 3.8环境下经过充分测试，使用更高版本可能会遇到兼容性问题。
必装工具
- Git：用于克隆项目代码仓库
- Python 3.8：项目运行的基础环境
- 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的主界面，如下图所示：
图1：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：编译安装包
- 启动Inno Setup
- 打开项目根目录下的
script.iss文件 - 点击工具栏上的"编译"按钮
- 等待编译完成，安装程序会生成在
releases目录下
图2：使用Inno Setup编译安装包示意图
目录结构解析
安装完成后，了解项目目录结构有助于更好地使用和定制工具：
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，你将看到以下主要功能区域：
- 一键清理：快速扫描并清理系统垃圾
- 高级清理：自定义清理规则和目标
- 空间分析：通过SpaceSniffer可视化磁盘使用情况
- 设置中心：自定义清理偏好和界面主题
选择你需要的功能，点击对应按钮即可开始使用。定期使用WindowsCleaner，可以让你的系统保持最佳状态！
建议每周运行一次全面清理，特别是在系统更新后或安装大型软件后。
许可证信息
WindowsCleaner采用开源许可证发布，详细信息请查看项目根目录下的LICENSE文件。你可以自由使用、修改和分享本软件，但请遵守开源协议要求。
通过本指南，你已经掌握了WindowsCleaner的各种安装方式和基本使用方法。无论是普通用户还是高级开发者，都能找到适合自己的使用方案。现在，让我们开始清理C盘，给系统来一次彻底的"大扫除"吧！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
