Yarn安装candy-machine-ui时无法安装@material-ui/icons依赖如何解决

• 缓存清理重装
  大部分安装失败是本地缓存损坏、锁文件冲突导致，直接在项目根目录依次执行以下命令清理后重装：

  # 清理yarn全局缓存
  yarn cache clean
  # 删除本地依赖文件夹和锁文件
  rm -rf node_modules yarn.lock
  # 重新执行依赖安装
  yarn install
  

• 核对依赖版本匹配
  @material-ui/icons 必须和项目内的 @material-ui/core 版本严格对齐，且5.x版本的Material UI已经将包名改为@mui/icons-material，如果项目用的是4.x版本的core，装5.x的icons必然报错。打开package.json确认core的版本号后，手动安装对应版本的icons即可：

  # 示例：core版本为4.12.4时，安装同版本icons
  yarn add @material-ui/icons@4.12.4
  

• 切换国内镜像源
  国内网络环境拉取海外npm仓库资源容易出现超时、连接中断问题，先切换yarn源到国内镜像再安装：

  yarn config set registry https://registry.npmmirror.com
  yarn install
  

• 适配Node版本
  公开版candy-machine-ui属于较早的项目，对高版本Node兼容性差，优先切换到Node 16.x版本再执行安装，Node 18、20版本会触发部分老依赖的原生编译错误。

针对图标包体积大、拉取超时的情况，可以执行yarn install --network-timeout 100000延长网络请求超时阈值，能解决大部分下载中断的问题。

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