使用npm i安装项目依赖失败，安装出错寻求技术协助

以下是针对npm安装依赖失败的常见解决方法，按优先级尝试：

• 切换国内npm镜像源
  海外源访问不稳定是常见问题，切换到国内镜像：

  npm config set registry https://registry.npmmirror.com/
  

  执行完成后重新运行：

  npm i
  

• 清理缓存并重新安装
  缓存损坏或残留的依赖文件可能导致安装异常：

  npm cache clean --force
  # 删除本地依赖目录和锁文件
  rm -rf node_modules package-lock.json
  # Windows系统执行以下命令：
  # rmdir /s /q node_modules && del package-lock.json
  npm i
  

• 处理权限问题
  若报错包含EACCES权限提示，可通过以下方式解决：

  • 配置npm全局目录权限（推荐）：

    mkdir ~/.npm-global
    npm config set prefix '~/.npm-global'
    

    随后将~/.npm-global/bin添加到系统PATH环境变量，重启终端后重新执行npm i
  • 临时使用unsafe-perm参数安装：

    npm i --unsafe-perm
    

• 绕过peer依赖冲突
  若错误提示涉及peer依赖版本不兼容，可尝试：

  npm i --legacy-peer-deps
  

内容的提问来源于stack exchange，提问作者Valentino Fabris Valenti