Cypress 10.0+配置文件无效 报Cannot find module 'cypress'错误

你提供的cypress.config.js配置语法完全符合Cypress 10.0及以上版本的格式要求，抛出Error: Cannot find module 'cypress'错误和配置内容无关，本质是运行环境无法正确定位到本地安装的Cypress依赖包。

• 确认Cypress依赖已正确安装
  在项目根目录（存放package.json的目录）执行对应包管理器的安装命令：
  • npm 环境：npm install cypress --save-dev
  • yarn 环境：yarn add cypress --dev
  • pnpm 环境：pnpm add cypress -D
    安装完成后检查项目node_modules目录下是否存在cypress文件夹，确认安装过程无权限、网络类报错。
• 确认配置文件存放路径正确
  Cypress 10+ 默认读取项目根目录下的cypress.config.js作为配置文件，如果你的配置文件存放在子目录中，直接运行Cypress命令时会因为路径上下文错误找不到依赖。如果因项目结构需要将配置文件放在子目录，运行时必须通过--config-file参数传入配置文件的绝对路径。
• 修正Cypress启动方式
  不要直接调用全局安装的Cypress命令，优先通过package.json中配置的脚本启动：

  {
    "scripts": {
      "cypress:open": "cypress open",
      "cypress:run": "cypress run"
    }
  }
  

  配置完成后通过npm run cypress:open/npm run cypress:run执行命令，会自动优先读取本地项目内安装的Cypress依赖，避免全局版本和本地版本不匹配导致的模块找不到问题。如果需要直接调用命令行，使用npx cypress open/npx cypress run启动即可，npx会自动定位本地项目的Cypress依赖。
  注意：不推荐全局安装Cypress，全局版本和本地项目依赖的Cypress版本不一致时，极易出现模块解析失败、配置不兼容类问题。
• 缓存异常兜底修复
  如果以上步骤操作后仍报错，先删除项目下的node_modules目录和对应依赖锁文件（package-lock.json/yarn.lock/pnpm-lock.yaml），执行npx cypress cache clear清除Cypress全局缓存后，重新执行依赖安装命令即可。

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