核心功能
npkill 是专为 JavaScript 和 Next.js 开发者设计的磁盘清理工具,用于定位并删除累积的 node_modules 和 .next 构建文件夹。这些依赖目录随项目数量增长可轻易占用数十 GB 空间。
显著优点
1. 交互式安全删除:默认启动 TUI 界面,逐个项目确认删除,避免误删
2. 干运行预览:--dry-run 模式先展示待删内容,零风险决策
3. 灵活目标切换:--target .next 针对性清理 Next.js 构建产物
4. 体积可视化:支持 --gb 以 GB 为单位显示,快速识别空间大户
5. 目录定位扫描:--directory 指定搜索起点,避免全盘遍历
潜在局限
- 外部依赖:需全局安装
npm install -g npkill - 终端兼容性:交互模式依赖箭头键支持,部分 CI/SSH 环境受限
- 保护目录盲区:⚠️ 标记的系统目录警告并非绝对完整
- 无版本控制感知:不自动识别.git 关联项目,需人工判断保留价值
适合人群
- 本地维护多个 JavaScript/Node.js/Next.js 项目的开发者
- 磁盘空间紧张需定期清理构建产物的工程师
- 希望可视化了解各项目依赖体积占用的技术管理者
常规风险
- 误删活跃项目依赖:未 dry-run 直接
--delete-all --yes可能导致正在开发的项目无法运行 - 权限问题:扫描系统目录可能触发权限警告,但不会越权删除
- 重建成本:删除后重新
npm install需耗时下载,CI 环境慎用
使用建议
首次使用务必执行 npkill --dry-run,确认无误后切换交互模式逐条审核。建议配合 --sort=size 优先处理体积最大的目录。