VSCode中Cypress测试无法运行的主因是工作区未信任、插件未找到配置文件路径或调试器未正确连接Electron进程；需检查全局cypress安装、配置文件位置与格式、Node.js版本兼容性，并确保通过“Debug”按钮启动调试。
VSCode 里 Cypress 测试根本跑不起来？先确认 cypress 是全局可执行的
VSCode 本身不运行 Cypress，它只是调用你系统里装好的 cypress CLI。如果点“Run”没反应、终端报 command not found: cypress，问题大概率出在这儿。
- 在 VSCode 终端里直接运行
npx cypress open—— 如果能打开 GUI，说明项目级依赖正常；但插件可能仍无法识别，因为 VSCode 插件默认找的是全局cypress - 运行
which cypress（macOS/Linux）或where cypress（Windows），看有没有输出路径；没有就说明没全局安装，别急着配插件 - 全局安装命令是
npm install -g cypress，但更推荐用npx cypress配合插件配置：在 VSCode 设置里搜cypress.runCommand，改成npx cypress run或npx cypress open - 注意 Node.js 版本兼容性：
cypress@12+要求 Node.js ≥ 16.14，cypress@13+要求 ≥ 18.12，错配会导致ERR_OSSL_EVP_UNSUPPORTED这类底层错误
Cypress Test Explorer 插件点“Run”没反应？检查 cypress.json 或 cypress.config.js 路径是否被识别
这个插件不是靠“有没有配置文件”来工作的，而是靠它能不能在工作区根目录下找到合法的 Cypress 配置入口。找不到，就当普通文件处理，测试项根本不加载。
- 插件默认只认项目根目录下的
cypress.json或cypress.config.js；如果你的配置在tests/e2e/cypress.config.ts，它直接无视 - 解决办法：在 VSCode 工作区设置里加
"cypress.configFile": "tests/e2e/cypress.config.ts"，路径必须是相对于工作区根目录的 - 注意
cypress.config.js导出必须是 CommonJS（module.exports = {...}），ESM（export default {...}）在旧版插件里不支持，会静默失败 - 配置文件里
e2e.setupNodeEvents如果用了异步函数或顶层 await，某些插件版本会卡住，建议先注释掉验证是否是它导致测试列表为空
断点调试 Cypress 测试时，VSCode 停不下来？关键在 debugger 和启动方式
Cypress 运行在 Electron 环境里，VSCode 的调试器要连上它，得走专用通道。单纯在测试代码里写 debugger 是没用的，除非你用对了启动方式。
- 必须通过插件的 “Debug” 按钮（小虫图标）启动，而不是“Run”按钮；或者手动在终端执行
npx cypress open --browser electron再选测试，否则 Chrome DevTools 调试器不会和 VSCode 同步 -
debugger语句只在cy.visit()之后、且页面已加载完成的上下文中生效；放在beforeEach里或cy.visit()前，基本停不住 - 如果用了
cypress.config.js里的setupNodeEvents注入自定义任务，那些 Node.js 端代码可以用 VSCode 的 Node.js 调试器单独 attach，但和浏览器端断点无关 - VSCode 调试配置里不要手动写
launch.json—— Cypress Test Explorer 插件自带预设，自己配容易漏resolveSourceMapLocations导致断点偏移
运行时报 Cannot find module 'cypress' 或 EACCES: permission denied？权限和 workspace trust 是隐形开关
VSCode 从 1.79 开始默认启用 Workspace Trust，未信任的工作区会禁用所有自动执行逻辑，包括插件调用 npx、读取 node_modules，甚至阻止终端里的 npm 执行。
- 右下角状态栏看到黄色盾牌图标？点它 → “Trust this workspace”，否则插件根本不会尝试加载
cypress -
EACCES错误常见于 macOS/Linux 下用sudo npm install -g装了 Cypress，导致全局 bin 目录权限混乱；改用corepack或nvm管理 Node.js，避免 sudo - 多根工作区（multi-root workspace）下，Cypress 插件只认第一个文件夹为“主项目”，其他文件夹里的
cypress.config.js默认无效，需显式配置cypress.configFile指向对应路径 - Windows 用户遇到路径里有空格（比如
C:\Users\John Doe\project），npx可能解析失败，建议把项目移到无空格路径，如C:\dev\myapp
