npm ERR! code ENOTEMPTY npm ERR! syscall rename

`npm ERR! code ENOTEMPTY` 是 Node.js 包管理器（Node Package Manager, npm）中常见的错误代码，当尝试删除或更新目录时遇到文件或子目录非空的情况就会触发这个错误。具体来说，当你试图执行 `npm install`, `npm uninstall`, 或 `npm ci` 等操作，如果依赖包的目录下已有其他内容（比如已安装的模块文件），而这些文件没有被清理干净，npm 就会返回这个错误。

解决这个问题通常需要手动删除或移除目标目录下的多余文件，或者在某些情况下，确保你的项目已经正确地完成了依赖卸载和重新安装的过程。你可以按照以下步骤尝试：

1. 清理旧的依赖：在可能冲突的文件夹里检查是否有不需要的文件，然后删除它们。

   rm -rf /path/to/dependency_folder

2. 使用 `npm cache clean --force` 清理缓存：

   npm cache clean --force
   npm install

3. 如果是更新操作，确保之前安装的版本已经被完全卸载：

   npm uninstall package_name -f
   npm install package_name@latest

4. 如果以上都不奏效，确认是否还有其他未预期的进程正在占用这些文件，关闭它们再试。

相关问题

+ npm install npm ERR! code ENOTEMPTY npm ERR! syscall rename

### 解决 `npm install` 出现 `ENOTEMPTY` 错误的方法

当遇到 `npm install` 报错显示 `ENOTEMPTY` 的情况时，这通常意味着尝试删除一个非空目录失败。此类问题可能由多种因素引起，包括权限不足、文件锁定或其他进程正在使用这些文件。

#### 方法一：清理残留文件夹
如果之前有未完成的操作或异常中断的情况发生，则可能会留下一些临时文件或锁住某些资源。可以手动进入项目的node_modules文件夹路径下，先移除该文件夹内的所有内容再重试安装命令：

rm -rf node_modules/
npm cache clean --force
npm install

上述命令会强制清除本地缓存并重新下载依赖项[^1]。

#### 方法二：关闭其他占用端口的应用程序和服务
有时其他应用程序也可能占用了必要的端口号或者其他系统资源，从而阻止了正常的构建过程。确保没有任何不必要的服务运行着，并且IDE等开发工具也没有打开过多实例[^2]。

#### 方法三：更新 npm 和 Node.js 版本
过旧版本的Node.js 或者 npm 可能存在兼容性问题或者是 bug ，因此建议定期检查官方文档来获取最新的稳定版信息，并按照指引升级环境配置:

npm install -g npm@latest
nvm use stable

这里假设读者已经安装好了 nvm (Node Version Manager)，它可以帮助管理多个不同版本之间的切换[^3]。

npm ERR! code ENOTEMPTY npm ERR! syscall rename npm ERR! path /usr/local/lib/node_modules/@vue/cli npm ERR! dest /usr/local/lib/node_modules/@vue/.cli-pPsrUrBg npm ERR! errno -66 npm ERR! ENOTEMPTY: directory not empty, rename '/usr/local/lib/node_modules/@vue/cli' -> '/usr/local/lib/node_modules/@vue/.cli-pPsrUrBg' npm ERR! A complete log of this run can be found in: npm ERR! /Users/yanggang/.npm/_logs/2023-04-22T12_54_27_547Z-debug-0.log

这个错误通常是由于在未删除现有目录的情况下尝试将其重命名而导致的。 为了解决此问题，可以尝试在进行重命名之前，先手动删除目标目录（即 /usr/local/lib/node_modules/@vue/.cli-pPsrUrBg）。 如果目标目录不重要，也可以尝试直接删除它并重新运行 npm 安装命令。 如果问题仍然存在，您可以查看日志文件以获得进一步的调试信息。