English | 中文

---

CleanMyProj

一键清理项目缓存，释放磁盘空间

自动检测项目类型 · 扫描缓存占用 · 交互式选择 · 安全移至回收站

---

为什么需要 CleanMyProj

开发久了，各种 node_modules、.next、__pycache__、target 散落在项目里，占用大量磁盘空间。手动查找和删除这些缓存目录既麻烦又容易误删。

CleanMyProj 帮你：

• 一个命令扫描项目中所有可清理的缓存
• 按占用大小排序，清晰展示哪些最占空间
• 勾选后统一移至系统回收站（不是直接删除）

安装

npm install -g cleanmyproj

使用

在任意项目根目录下执行：

cmpj

典型输出

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  CleanMyProj — 项目缓存清理工具
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  项目路径: /Users/dev/my-project
  检测类型: nextjs
  框架技术: Next.js, React, TypeScript

  共发现 5 项缓存，总计占用 2.37 GB

? 选择要清理的项目 (空格勾选, Enter 确认):
 ◻ ✦ 全选 (All) — 总计: 2.37 GB
 ◻   .next (Next.js build cache)                    1.24 GB
 ◻   node_modules                                   890.52 MB
 ◻   node_modules/.vite (Vite cache)               156.30 MB
 ◻   .eslintcache                                    12.80 MB
 ◻   node_modules/.cache (Webpack/Babel)              8.45 MB

命令

cmpj                     # 当前目录：扫描 → 交互选择 → 清理
cmpj /path/to/project    # 指定项目路径
cmpj --check             # 只看结果，不执行清理
cmpj --yes               # 跳过确认直接清理（谨慎使用）

操作说明

按键	作用
空格	勾选 / 取消勾选
↑ ↓	上下移动光标
Enter	确认选择

选择后会经历两次确认：

1. 第一次 Enter → 显示将要清理的项目列表，要求确认
2. 第二次 Enter → 最终执行，文件移至系统回收站

支持的项目类型

类型	可清理内容
Node.js	node_modules、npm / yarn / pnpm 全局缓存、node_modules/.cache、.eslintcache
Next.js	.next 构建缓存
Nuxt	.nuxt、.output
Vite	node_modules/.vite
Vue / Svelte	dist、.svelte-kit
Angular	.angular、dist
Gatsby	.cache、public
Python	__pycache__、.venv、pip 缓存
Rust	target/、cargo registry
Go	build cache、module cache
Flutter	build/、.dart_tool、pub cache
Java	build/、target/、Gradle 缓存、Maven 本地仓库
Docker	未使用的镜像、容器、卷
Turborepo	.turbo 本地缓存

安全性

特性	说明
🗑️ 移至回收站	所有文件进入系统回收站（macOS 废纸篓 / Windows 回收站 / Linux Trash），可手动恢复
☑️ 默认不选	所有选项默认未勾选，由你决定清理哪些
🔒 双重确认	执行前需两次确认，防误操作
🚫 不碰源码	仅清理缓存和构建产物，不影响源代码和配置文件

常见问题

删除的文件能恢复吗？

可以。所有删除操作实质是「移动到回收站」，打开系统的回收站即可恢复。

支持 monorepo 吗？

支持。在 monorepo 根目录运行 cmpj，会扫描所有子项目的缓存。

会误删源代码吗？

不会。CleanMyProj 只会清理预定义的缓存目录（如 node_modules、.next、target 等），不会删除任何源代码文件。

Windows 能用吗？

能。支持 macOS、Windows 和 Linux，文件会被移至各自的系统回收站。

贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建分支 (git checkout -b feature/your-feature)
3. 提交更改 (git commit -m 'feat: add something')
4. 推送分支 (git push origin feature/your-feature)
5. 提交 Pull Request

许可证

MIT © ceasarXuu