Cypress升级后启动报错求助及默认二进制仓库修改方法咨询

一、解决启动时找不到旧版本路径的问题 #

针对cypress open仍查找7.2.0版本路径的问题，按以下步骤排查：

1. 彻底清理并重装全局Cypress #

可能全局安装的CLI仍残留旧版本关联，执行以下命令：

# 卸载全局Cypress
npm uninstall -g cypress
# 重新全局安装指定版本
npm install -g cypress@13.6.6

2. 检查本地项目依赖（若在项目内启动） #

如果是在项目目录下执行cypress open，可能项目本地依赖的还是旧版本：

• 删除项目根目录的node_modules和package-lock.json
• 更新项目依赖：

npm install cypress@13.6.6 --save-dev

• 用项目本地的Cypress启动：

npx cypress open

3. 修正二进制路径指定方式 #

Mac系统下Cypress的可执行文件路径并非直接指向Cypress，而是在App包内部，尝试用完整路径指定：

CYPRESS_RUN_BINARY="/Users/xxxx/Library/Caches/Cypress/13.6.6/Cypress.app/Contents/MacOS/Cypress" cypress open

4. 清理残留环境变量 #

检查你的shell配置文件（如.zshrc、.bashrc），如果之前添加过CYPRESS_INSTALL_BINARY或旧的CYPRESS_RUN_BINARY配置，删除后重启终端再尝试启动。

二、修改Cypress二进制包的默认缓存仓库 #

有两种方式可以自定义缓存目录：

1. 通过环境变量全局设置 #

在shell配置文件（.zshrc/.bashrc）中添加以下配置，保存后重启终端：

export CYPRESS_CACHE_FOLDER="/your/custom/cache/path"

后续安装和启动Cypress时，会自动使用这个自定义路径存储和查找二进制包。

2. 通过项目配置文件局部设置 #

在项目根目录的cypress.config.js中添加cacheFolder配置：

const { defineConfig } = require('cypress')

module.exports = defineConfig({
  cacheFolder: '/your/custom/cache/path',
  // 其他Cypress配置项
})

这种方式仅对当前项目生效。

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