NPkill - Node.js 和 Next.js 构建产物清理工具

此技能利用 npkill 工具来清理 JavaScript 和 Next.js 开发过程中随时间累积的 node_modules 和 .next 文件夹，从而释放大量磁盘空间。

目的

此技能旨在解决 JavaScript 和 Next.js 开发者面临的一个常见问题：大型构建产物文件夹（node_modules、.next）随时间累积，消耗大量磁盘空间。它提供了一种安全高效的方法来识别和删除这些不必要的文件夹。

何时使用此技能

在以下情况下使用此技能：

• 由于累积的 node_modules 文件夹导致磁盘空间不足时
• 需要清理旧的 Next.js 构建产物（.next 文件夹）时
• 需要维护一个整洁的开发环境时
• 需要识别哪些项目占用了最多的磁盘空间时
• 需要对开发工作区进行定期维护时

核心命令

交互式清理（推荐）

npkill

启动交互式界面以浏览并有选择地删除 node_modules 文件夹。这是最安全的方法，因为它允许您在删除前查看每个文件夹。

具体针对 .next 文件夹

npkill --target .next

专门搜索 .next 文件夹（由 Next.js 项目使用），而不是 node_modules。

试运行（始终建议先执行此操作）

npkill --dry-run

模拟操作而不实际删除任何内容。显示将会删除的内容。

自动清理（谨慎使用）

npkill --delete-all --yes

自动删除找到的所有 node_modules 文件夹。请务必在试运行验证后再使用。

以千兆字节为单位查看大小

npkill --gb

以千兆字节（GB）而非兆字节（MB）显示文件夹大小，以便于阅读。

从特定目录开始扫描

npkill --directory /path/to/search/from

从特定目录而非当前目录开始搜索。

安全功能

• 受保护目录警告: npkill 会使用 ⚠️ 符号高亮显示不应删除的系统/应用程序目录
• 交互式确认: 在交互模式下需要手动选择
• 试运行选项: 在执行任何删除操作前预览更改
• 排除选项能够从扫描中排除特定目录

Next.js 开发者的常见使用场景

安全清理 .next 文件夹

# First, preview what would be deleted
npkill --target .next --dry-run

# Then, if satisfied with the preview, run interactively
npkill --target .next

定期维护

# Run interactive cleanup to review and selectively delete
npkill

检查磁盘使用情况

# View all node_modules folders sorted by size
npkill --sort=size

最佳实践

1. 始终先使用 --dry-run 参数运行以查看将要删除的内容
2. 仔细查看警告信息关于标有 ⚠️ 的受保护目录
3. 使用交互模式以便更安全地进行选择性删除
4. 考虑排除重要的项目目录如有需要，可使用 --exclude 参数
5. 安排定期清理以防止大量累积

安装要求

此功能要求全局安装 npkill CLI 工具：

npm install -g npkill

限制

• 需要单独安装 npkill
• 并非在所有环境下都能检测到所有受保护的系统目录
• 交互模式需要终端支持方向键功能