Node.js最新LTS版本下使用NPM/YARN无法安装Strapi求助

环境信息 #

• Node.js版本：v18.12.1（LTS）
• npm版本：8.19.2
• Yarn版本：3.3.1

执行的操作 #

1. 按Strapi官方指引执行命令：npx create-strapi-app@latest my-project --quickstart，创建项目时报错
2. 进入my-project目录执行yarn install，仍出现错误
3. 尝试使用yarn create strapi-app my-project重新安装，问题未解决

操作问题排查与解决方案 #

你的操作步骤本身符合官方指引，但环境兼容性和工具配置可能是导致失败的关键：

1. Node.js与Strapi版本兼容性 #

Strapi v4.10及以上版本才正式支持Node.js 18 LTS。如果create-strapi-app@latest拉取的是旧版本Strapi，会出现兼容问题。

• 解决：指定兼容Node.js 18的Strapi版本创建项目，例如：

  npx create-strapi-app@4.10.0 my-project --quickstart
  

2. Yarn 3（Berry）的兼容性问题 #

Yarn 3的PnP（Plug'n'Play）模式与Strapi的依赖安装逻辑可能存在冲突，部分版本的Strapi初始化脚本对Yarn 3支持不完善。

• 解决1：切换Yarn到传统node-modules模式，再重新安装：

  yarn config set nodeLinker node-modules
  cd my-project
  yarn install
  

• 解决2：改用npm进行项目初始化和依赖安装，避免Yarn 3的兼容性问题：

  npx create-strapi-app@latest my-project --quickstart --npm
  

3. npx缓存问题 #

npx可能缓存了旧版本的create-strapi-app，导致拉取的Strapi版本不兼容当前Node.js。

• 解决：清理npx缓存后重新执行命令：

  npx clear-npx-cache
  npx create-strapi-app@latest my-project --quickstart
  

4. 网络或权限问题 #

• 网络：依赖包下载失败会导致安装中断，可切换国内镜像源：

  # npm镜像切换
  npm config set registry https://registry.npmmirror.com/
  # Yarn镜像切换
  yarn config set registry https://registry.npmmirror.com/
  

• 权限：本地目录权限不足时，尝试用管理员权限运行终端，或修改项目目录权限。

结论 #

你的操作步骤本身没有错误，问题出在环境配置的兼容性上。通过调整Strapi版本、切换Yarn模式或改用npm，大概率能解决项目创建失败的问题。

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