新增Cypress测试用例未在UI中显示可用问题求助

校验测试文件命名规则 #

• Cypress默认仅识别后缀为.cy.js/.cy.ts/.cy.jsx/.cy.tsx的文件作为测试用例，若使用普通.js/.ts后缀未添加.cy标识，需要修改命名或调整配置规则
• 确认测试文件未使用.txt/.json等非可执行测试文件后缀

核对配置文件的路径规则 #

• 若使用Cypress v10及以上版本，默认已废除integrations文件夹作为测试用例默认存储目录，默认目录改为cypress/e2e，可选择将测试文件迁移到默认目录，或在cypress.config.js中修改specPattern字段指定自定义路径：

  // cypress.config.js 配置示例
  const { defineConfig } = require('cypress')
  module.exports = defineConfig({
    e2e: {
      specPattern: 'cypress/integrations/**/*.cy.{js,jsx,ts,tsx}'
    }
  })
  

• 若使用v9及以下版本，检查cypress.json中的integrationFolder配置是否正确指向测试用例存储文件夹，testFiles配置的通配符是否匹配测试文件命名规则，注意路径大小写，macOS/Linux系统对大小写敏感，路径写错会导致识别失败

排查文件权限与目录结构问题 #

• 检查integrations文件夹及内部测试文件的读取权限，确认当前运行Cypress的用户拥有文件读取权限
• 检查文件夹层级是否存在特殊字符、空格、中文命名，旧版本Cypress对特殊字符路径兼容性较差，建议改为纯英文无特殊符号的路径
• 确认测试文件放在integrations子目录中时，配置的通配符添加了**用于递归匹配所有子层级目录

检查运行环境与依赖完整性 #

• 执行npx cypress verify命令校验Cypress安装是否完整，若有损坏可执行npx cypress install --force重新安装
• 关闭Cypress UI后执行npx cypress cache clear彻底清理缓存，再重新启动UI界面
• 检查项目中是否存在.gitignore或者.cypressignore文件将自定义测试用例目录加入了忽略名单，导致Cypress无法扫描到对应文件

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