# FileCleaner

**Repository Path**: javakam/FileCleaner

## Basic Information

- **Project Name**: FileCleaner
- **Description**: 主要用于删除开发中产生的临时目录 build,out,target,.idea 等, 后面会支持自定义目录
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2023-05-26
- **Last Updated**: 2025-12-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FileCleaner

一个用于清理项目临时编译目录的工具，提供Java和Python两个版本。

项目地址: <https://gitee.com/javakam/FileCleaner>

## 功能特性

- 🧹 清理项目的临时编译目录（build、classes、target、node_modules等）
- 📊 计算和查看目录中所有文件的大小，识别大文件
- ⚙️ 支持自定义清理目录列表和忽略列表
- 🎨 提供现代化的图形用户界面（GUI）
- 🌓 支持亮色/暗色主题自动切换（Python版本）
- 📝 实时日志输出和详细统计信息

## 版本说明

本项目提供两个版本：

### [Java版本](java_version/) - 传统稳定

- 基于 Java Swing 开发
- 传统界面风格，稳定可靠
- 需要 Java 运行环境（JRE 8+）
- 打包体积小（~15-30MB）
- 适合 Java 开发者使用
- 详见：[java_version/README.md](java_version/README.md)

### [Python版本](python_version/) - 现代推荐 ⭐

- 基于 Python CustomTkinter 开发
- 现代化界面设计，支持主题切换
- 支持打包为独立可执行文件
- 功能更加丰富和现代化
- 开发效率高，易于扩展
- 详见：[python_version/README.md](python_version/README.md)

## 快速开始

### Java版本

```bash
cd java_version
# 方式1: 直接运行JAR
java -jar FileCleaner.jar

# 方式2: 使用批处理脚本
run.bat
```

### Python版本

```bash
cd python_version
# 安装依赖
pip install -r requirements.txt

# 方式1: 运行Python脚本
python main.py

# 方式2: 使用批处理脚本
start.bat

# 方式3: 打包为EXE
python build_exe.py
```

## 版本对比

| 特性 | Java版本 | Python版本 |
|------|---------|-----------|
| GUI框架 | Swing | CustomTkinter |
| 界面风格 | 传统 | 现代化 |
| 主题支持 | ❌ | ✅ 亮色/暗色 |
| 打包体积 | ~15-30MB | ~30-50MB |
| 启动速度 | 快 | 快 |
| 开发效率 | 中等 | 高 |
| 易于扩展 | 中等 | 高 |
| 依赖要求 | JRE 8+ | Python 3.7+ |
| 推荐度 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |

## 项目结构

```
FileCleaner/
├── README.md                  # 项目主说明文档
├── .gitignore                 # Git忽略配置
│
├── java_version/              # Java版本
│   ├── src/                   # Java源代码
│   │   └── main/
│   │       ├── java/          # Java源文件
│   │       └── resources/     # 资源文件
│   ├── target/                # Maven构建输出
│   ├── screenshot/            # 截图
│   ├── pom.xml                # Maven配置
│   ├── javapackager.bat       # 打包脚本
│   ├── run.bat                # 运行脚本
│   └── README.md              # Java版本说明
│
└── python_version/            # Python版本
    ├── src/                   # Python源代码
    │   ├── gui/               # GUI模块
    │   ├── core/              # 核心功能
    │   └── utils/             # 工具模块
    ├── assets/                # 资源文件
    ├── dist/                  # 打包输出
    ├── main.py                # 主入口
    ├── build_exe.py           # 打包脚本
    ├── build.bat              # 打包批处理
    ├── start.bat              # 启动脚本
    ├── requirements.txt       # 依赖列表
    └── README.md              # Python版本说明
```

## 使用场景

- 🎯 清理Android项目的build目录
- 🎯 清理Maven/Gradle项目的target目录
- 🎯 清理Node.js项目的node_modules目录
- 🎯 清理Python项目的__pycache__目录
- 🎯 批量清理多个项目，释放磁盘空间
- 🎯 查找和删除大文件

## 注意事项

⚠️ **重要提示**：
1. 清理操作不可逆，请谨慎使用
2. 建议在清理前备份重要文件
3. 某些文件可能因权限问题无法删除
4. 当清理目录和忽略目录同时勾选了相同文件名的目录时，不会删除该目录
5. 程序运行的目录为第1层

## 贡献

欢迎提交 Issue 和 Pull Request！

## 许可证

本项目遵循开源许可证，具体请查看项目仓库。

## 更新日志

### 2025-12
- 重构项目结构，将Java版本和Python版本分离
- Python版本升级到CustomTkinter，支持现代化主题
- 完善文档和.gitignore配置

### 2023-08
- 初始版本发布
- 实现基本的文件清理和大小计算功能