Cypress在VSCode中无法运行，主因是插件默认调用全局cypress而非项目npx cypress，且仅识别根目录cypress.config.js（CommonJS语法），调试需点击插件“Debug”按钮启用Electron通道。
Cypress 在 VSCode 里跑不起来，90% 是因为 Node 环境没对上，或者 VSCode 插件根本没连到项目里的 Cypress —— 它不认全局安装，也不自动继承你终端的 PATH。
为什么 cypress open 在终端能跑，VSCode 里点 “Run” 却没反应？
VSCode 的 Cypress 插件（比如 Cypress Test Explorer）默认调用的是全局 cypress 命令，不是项目里的 npx cypress。而现代项目几乎都把 cypress 装在 devDependencies 里，靠 npx 自动定位到 node_modules/.bin/cypress。
- 在 VSCode 集成终端运行
npx cypress open：能打开 GUI → 说明项目依赖正常；不能打开 → 检查package.json是否有"cypress"，且已执行npm install - 运行
which cypress（macOS/Linux）或where cypress（Windows）：无输出 → 没全局安装，但**不建议补装**，容易和项目版本冲突（比如cypress@13+Node 16会直接报ERR_OSSL_EVP_UNSUPPORTED） - 正确做法：VSCode 设置里搜
cypress.runCommand，改成npx cypress open或npx cypress run
cypress.config.js 或 cypress.config.ts 怎么写才被插件识别？
插件不是“扫描配置文件”，而是严格按路径、后缀、导出语法三者匹配。错一个，测试列表就是空的。
- 插件默认只认工作区根目录下的
cypress.config.js或cypress.json；cypress.config.ts不会被自动发现 - 如果配置在
tests/e2e/cypress.config.ts，必须在 VSCode 工作区设置（.vscode/settings.json）里加："cypress.configFile": "tests/e2e/cypress.config.ts"（路径是相对于工作区根） -
cypress.config.js必须用 CommonJS：module.exports = { ... }；export default { ... }在多数插件版本中静默失败 -
e2e.setupNodeEvents里用了async函数或顶层await？某些插件版本会卡住加载——调试时先注释掉验证
断点 debugger 为什么总不生效？
Cypress 运行在 Electron 渲染进程里，不是普通 Node.js 进程。VSCode 的 Node 调试器连不上，除非走专用通道。
- 纯靠
launch.json配type: "node"是无效的；debugger语句只有在 Electron DevTools 和 VSCode 同步时才触发 - 必须点击插件里的 “Debug” 按钮（小虫图标），它会自动启动
npx cypress open --browser electron并建立调试连接 - 手动方式：终端执行
npx cypress open --browser electron，再在 GUI 中选测试 → 此时 Chrome DevTools 的断点和 VSCode 编辑器同步 - 自定义环境变量（如
CYPRESS_BASE_URL、代理、NODE_OPTIONS）不会被 Electron 继承，得显式传入：例如CYPRESS_BASE_URL=http://localhost:3000 npx cypress open
最常被忽略的一点：Cypress Test Explorer 插件本身不提供测试面板 UI，它只是把本地 Cypress Runner 的测试结构“映射”进 VSCode。如果 npx cypress open 从没成功启动过一次，插件就拿不到任何测试元数据——哪怕配置全对，列表也为空。
