dev-cleaner

One-click cleanup tool for development junk files.

Features

• 🧹 Clean build artifacts, caches, and IDE junk
• 🛡️ Safe by default with dry-run preview mode
• 🌐 Cross-language support (Python, Node.js, and more)
• ⚡ Fast recursive scanning
• 🎯 Language-specific filtering options

Installation

From PyPI (Recommended)

pip install dev-cleaner

From Source

git clone https://github.com/xiyanbaby/dev_cleaner.git
cd dev_cleaner
pip install -e .

Usage

Basic Usage

Preview what will be cleaned (dry-run mode):

dev-cleaner --dry-run

Clean all development junk files:

dev-cleaner

Language-Specific Cleaning

Clean only Python files:

dev-cleaner --python

Clean only Node.js files:

dev-cleaner --node

Combine multiple languages:

dev-cleaner --python --node

Supported File Types

Python

• __pycache__ directories
• *.pyc compiled files
• .venv virtual environments
• .pytest_cache test caches

Node.js

• node_modules dependencies
• .cache directories
• .next Next.js build files
• .nuxt Nuxt.js build files

Build Artifacts

• build directories
• dist distribution files
• cmake-build-* CMake build files
• target Maven/Cargo target directories

IDE Files

• .vscode VS Code settings
• .idea JetBrains IDE settings

Miscellaneous

• .DS_Store macOS system files
• Thumbs.db Windows thumbnail cache
• *.log log files

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

xiyanbaby

Links

• GitHub Repository
• Issue Tracker

---

dev-cleaner（开发清理工具）

一键清理开发垃圾文件的工具。

功能特性

• 🧹 清理构建产物、缓存和IDE垃圾文件
• 🛡️ 默认安全模式，提供预览功能
• 🌐 跨语言支持（Python、Node.js等）
• ⚡ 快速递归扫描
• 🎯 支持按语言过滤

安装

从 PyPI 安装（推荐）

pip install dev-cleaner

从源码安装

git clone https://github.com/xiyanbaby/dev_cleaner.git
cd dev_cleaner
pip install -e .

使用方法

基本用法

预览将要清理的内容（试运行模式）：

dev-cleaner --dry-run

清理所有开发垃圾文件：

dev-cleaner

按语言清理

仅清理 Python 文件：

dev-cleaner --python

仅清理 Node.js 文件：

dev-cleaner --node

组合多种语言：

dev-cleaner --python --node

支持的文件类型

Python

• __pycache__ 目录
• *.pyc 编译文件
• .venv 虚拟环境
• .pytest_cache 测试缓存

Node.js

• node_modules 依赖目录
• .cache 缓存目录
• .next Next.js 构建文件
• .nuxt Nuxt.js 构建文件

构建产物

• build 目录
• dist 分发文件
• cmake-build-* CMake 构建文件
• target Maven/Cargo 目标目录

IDE 文件

• .vscode VS Code 设置
• .idea JetBrains IDE 设置

其他

• .DS_Store macOS 系统文件
• Thumbs.db Windows 缩略图缓存
• *.log 日志文件

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目采用 MIT 许可证 - 详情请参见 LICENSE 文件。

作者

xiyanbaby

链接

• GitHub 仓库
• 问题追踪