使用npx create-next-app@latest创建Next.js应用时遇ENOTEMPTY错误求助

问题背景 #

创建Next.js应用时触发npm ERR! ENOTEMPTY: directory not empty错误，此前该命令稳定运行一年，环境版本如下：

node version: v19.8.1
npm version: 9.5.1
React version: 18.2.0
Next version: 13.2.4
OS version: Ubuntu 22.04

错误截图：

解决步骤 #

• 清空目标目录
  命令指定的目标目录可能存在隐藏缓存文件（如.git、临时npm文件），即使视觉上为空也会触发错误。直接删除目录后重新执行创建命令：

  rm -rf <你的应用目录名>
  npx create-next-app@latest <你的应用目录名>
  

• 强制清理npm缓存
  缓存损坏可能导致文件操作异常，执行以下命令清理缓存后重试：

  npm cache clean --force
  

• 跳过自动安装依赖
  避免创建过程中依赖安装产生的临时文件冲突，先创建应用框架再手动安装依赖：

  npx create-next-app@latest <你的应用目录名> --no-install
  cd <你的应用目录名>
  npm install
  

• 修复目录权限
  Ubuntu系统下目录权限不足会导致npm无法正常读写文件，检查并调整目标目录父路径的权限：

  # 查看权限状态
  ls -ld <目标目录的父路径>
  # 赋予当前用户目录所有权
  sudo chown -R $USER:$USER <目标目录的父路径>
  

内容的提问来源于stack exchange，提问作者MN.