Cypress测试文件丢失问题及正确添加方式咨询

问题概述 #

自行在项目根目录创建integration文件夹并添加测试文件时，Cypress无法识别；将测试移至自带的2-advanced-examples文件夹后可正常运行，但后续启动Cypress时，VS Code中可见的cookies_popup.cy.js、test_login.cy.js测试文件在Cypress界面中消失，重启Cypress、重新添加文件后问题依旧。

正确测试文件添加方式 #

• 使用官方默认测试目录
  Cypress新版本默认识别cypress/e2e目录（旧版本为cypress/integration），直接在该目录下创建专属子文件夹（如my-custom-tests）存放你的测试文件，不要自行在项目根目录新建integration文件夹，避免识别异常。

• 严格遵循命名规则
  测试文件名必须以.cy.js、.cy.ts、.cy.jsx或.cy.tsx结尾，避免特殊字符和空格，推荐用下划线/短横线分隔名称，确保Cypress能正常扫描到文件。

• 检查配置文件路径
  打开cypress.config.js（或.ts），确认e2e.specPattern（旧版本为integrationFolder）配置指向正确的测试目录，示例配置：

  module.exports = {
    e2e: {
      specPattern: 'cypress/e2e/**/*.cy.{js,jsx,ts,tsx}'
    }
  }
  

  若自定义目录，需保证路径准确且目录实际存在。

• 不要使用官方示例目录存放自定义测试
  2-advanced-examples是官方示例目录，后续可能因Cypress更新、配置重置导致自定义测试文件丢失，务必将自己的测试放在专属子文件夹中。

• 验证文件实际存在性
  若VS Code显示文件但Cypress不识别，可通过系统文件管理器查看对应目录，确认文件真实存在且拥有读写权限，排除VS Code缓存显示的问题。

相关截图 #

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