
Cypress 是新一代的 web UI 自动化测试框架,但是下载安装过程会遇到长时间的卡顿,导致安装失败。官方提供了解决方法,本文做一简单介绍。
目录
常规安装方法
最方便的安装方法是使用 npm
,使用下面的命令:
$ npm i cypress --save-dev
但是在某些环境下,从 npm
下载会遇到长时间没有响应,如下图中箭头所指:

好在 Cypress 官方提供了额外的下载方法,这个方法与 Puppeteer 的下载方法 类似,都是通过环境变量设置下载地址的方法。
下载地址
官方提供的压缩包下载地址为:https://download.cypress.io/desktop ,只要访问这个地址,就会自动检测你的操作系统,提供对应版本 cypress.zip 下载。
无论在什么系统下,Cypress 都以一个应用程序压缩包的形式存在:cypress.zip,如下图所示:

根据系统的不同,压缩包内的程序有不同的格式。比如:
Mac下是*.app
Linux下是可执行文件
Windows下是*.exe
指定安装路径
为了正常安装,要避开 npm 默认下载路径,然后指定安装包的引用路径:
- 使用官方下载地址
这种方法适合第一次安装,只要把下载地址 https://download.cypress.io/desktop
赋给环境变量 CYPRESS_DOWNLOAD_MIRROR
,在 npm install
时就能从官方地址下载。
- 指定本地的压缩包路径
这种方法适合已经有安装包,反复安装的情景。只要把本地文件地址(精确到文件名)赋给环境变量 CYPRESS_INSTALL_BINARY
,在 npm install
时就能自动下载并安装。
下面来看如何在不同系统下指定环境变量。
设置环境变量
Windows 命令行 (CMD)

在 Windows 的命令行下使用下面的命令设置 环境变量:
set CYPRESS_DOWNLOAD_MIRROR=https://download.cypress.io/desktop
或者
set CYPRESS_INSTALL_BINARY=D:\path\to\your\app\cypress.zip
顺利安装效果如下图:

Windows PowerShell

在 Windows 的 PowerShell 里, set
不能用来设置 环境变量,需要改用 $env
D:> $env:CYPRESS_DOWNLOAD_MIRROR="https://download.cypress.io/desktop"
或者
D:> $env:CYPRESS_INSTALL_BINARY="D:\path\to\your\app\cypress.zip"
顺利安装效果如下图:
在线下载安装:

指定本地路径:

Linux、Mac

Linux、Mac 下直接给环境变量赋值即可:
$ CYPRESS_DOWNLOAD_MIRROR="https://download.cypress.io/desktop"
下载地址的其他参数
官方的 下载地址 除了基本的自动检测系统类型,还能用 URL 参数指定系统类型。参数列表如下:
参数名称 | 可选值 |
---|---|
platform | win32,linux,darwin |
arch | x64,ia32 |
如果指定下载 64bit Windows 的Cypress,使用下面的 URL:
https://download.cypress.io/desktop?platform=win32&arch=x64
真实的下载地址
官网将真实的下载地址存放在这个文件里:
https://download.cypress.io/desktop.json
访问效果如下:
