名称： npkill
描述： 使用 npkill 清理 node_modules 和 .next 文件夹以释放磁盘空间。专为 JavaScript 和 Next.js 开发者设计，帮助移除占用大量存储空间的累积构建产物。提供交互式和自动化清理选项，并包含安全检查以保护重要的系统目录。

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 文件夹。仅在通过模拟运行验证后使用。

以 GB 为单位查看大小

npkill --gb

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

从特定目录开始扫描

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

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

安全特性

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

Next.js 开发者常见用例

安全清理 .next 文件夹

# 首先，预览将要删除的内容
npkill --target .next --dry-run

# 然后，如果对预览结果满意，运行交互式清理
npkill --target .next

定期维护

# 运行交互式清理，审查并选择性删除
npkill

检查磁盘使用情况

# 查看所有按大小排序的 node_modules 文件夹
npkill --sort=size

最佳实践

1. 始终先使用 --dry-run 查看将要删除的内容。
2. 仔细审查警告，特别是标记有 ⚠️ 的受保护目录。
3. 使用交互模式 进行更安全的选择性删除。
4. 考虑使用 --exclude 排除重要的项目目录（如果需要）。
5. 安排定期清理，防止大量累积。

安装要求

本技能要求全局安装 npkill CLI 工具：

npm install -g npkill

限制

• 需要单独安装 npkill。
• 可能无法在所有环境中检测到所有受保护的系统目录。
• 交互模式需要支持方向键的终端。