安装Cypress失败：npm命令卡住报错，使用--force参数仍无法解决

• 第一步：清理npm本地损坏缓存
  执行命令：npm cache clean --force
• 第二步：配置国内镜像源解决下载超时问题
  Cypress安装过程中会额外下载独立二进制包，默认境外源极易出现超时、下载失败问题，执行以下命令配置镜像：

  npm config set registry https://registry.npmmirror.com
  npm config set CYPRESS_DOWNLOAD_MIRROR https://cdn.npmmirror.com/binaries/cypress
  

• 第三步：清理项目内已生成的无效依赖文件
  删除项目根目录下的node_modules文件夹，以及package-lock.json（如果用yarn则删除yarn.lock，用pnpm则删除pnpm-lock.yaml）锁文件
• 第四步：重新执行安装命令
  无需加--force参数，直接执行：npm install cypress --save-dev

异常兜底方案 #

如果上述步骤仍无法解决问题，可尝试以下方案：

• 确认你的Node.js版本符合Cypress要求：当前最新版Cypress要求Node.js版本≥16.x，推荐使用18.x、20.x的LTS正式版本，版本过低会直接导致安装失败
• 手动下载对应版本的Cypress二进制包，放入本地缓存目录后再执行安装命令即可跳过下载步骤：
  Windows缓存路径：C:\Users\<你的系统用户名>\AppData\Local\Cypress\Cache
  macOS缓存路径：~/Library/Caches/Cypress
  Linux缓存路径：~/.cache/Cypress
• 切换包管理器安装：可以尝试用yarn add cypress --dev或者pnpm add cypress --save-dev完成安装

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