介绍
# NPkill - Node.js and Next.js Build Artifact Cleaner
此技能利用 npkill 工具清理随时间推移在 JavaScript 和 Next.js 开发中累积的 node_modules 和 .next 文件夹，从而释放大量磁盘空间。
## 目的
此技能解决了 JavaScript 和 Next.js 开发人员面临的常见问题：大型构建产物文件夹（node_modules、.next）随时间推移会占用大量磁盘空间。它提供了一种安全高效的方式来识别并删除这些不必要的文件夹。
## 何时使用此技能
在以下情况使用此技能： - 由于累积的 node_modules 文件夹导致磁盘空间不足 - 您希望清理旧的 Next.js 构建产物（.next 文件夹） - 您需要保持整洁的开发环境 - 您希望确定哪些项目占用的磁盘空间最多 - 您希望对开发工作区进行定期维护
## 核心命令
### 交互式清理（推荐） ```bash npkill ``` 启动交互式界面以浏览并有选择地删除 node_modules 文件夹。这是最安全的方法，因为它允许您在删除之前检查每个文件夹。
### 专门针对 .next 文件夹 ```bash npkill --target .next ``` 专门搜索 .next 文件夹（由 Next.js 项目使用），而不是 node_modules。
### 试运行（始终建议首先执行） ```bash npkill --dry-run ``` 模拟操作而不实际删除任何内容。显示将要删除的内容。
### 自动清理（请谨慎使用） ```bash npkill --delete-all --yes ``` 自动删除所有找到的 node_modules 文件夹。仅应在通过试运行验证后使用。
### 以千兆字节为单位显示大小 ```bash npkill --gb ``` 以千兆字节（而非兆字节）显示文件夹大小，以便于阅读。
### 从特定目录扫描 ```bash npkill --directory /path/to/search/from ``` 从特定目录开始搜索，而不是当前目录。
## 安全特性
- **受保护目录的警告**：npkill 会用 ⚠️ 符号突出显示不应删除的系统/应用程序目录 - **交互式确认**：交互模式中需要手动选择 - **试运行选项**：在执行任何删除之前预览更改 - **排除选项**：能够从扫描中排除特定目录
## Next.js 开发人员的常见用例
### 安全清理 .next 文件夹 ```bash # First, preview what would be deleted npkill --target .next --dry-run
# Then, if satisfied with the preview, run interactively npkill --target .next ```
### 定期维护 ```bash # Run interactive cleanup to review and selectively delete npkill ```
### 检查磁盘使用情况 ```bash # View all node_modules folders sorted by size npkill --sort=size ```
## 最佳实践
1. **始终首先运行 --dry-run** 以查看将要删除的内容 2. **仔细查看关于标有 ⚠️ 的受保护目录的警告** 3. **使用交互模式** 以便更安全地进行选择性删除 4. **如有需要，考虑使用 --exclude 排除重要的项目目录** 5. **安排定期清理** 以防止大量累积
## 安装要求
此技能需要全局安装 npkill CLI 工具： ```bash npm install -g npkill ```
## 限制
- 需要单独安装 npkill - 在所有环境中可能无法检测到所有受保护的系统目录 - 交互模式需要支持方向键的终端