webstorm 2025.2+ 边栏运行 vitest 测试失败主因是 --testnamepattern 参数格式错误（等号后多空格），pnpm monorepo 下需手动定位 vitest.mjs 路径，调试须用测试旁专用 debug 图标而非普通 node.js 模式。
WebStorm 2025.2+ 默认配置下直接点边栏图标运行 Vitest 测试，大概率失败——不是你配错了，是 IDE 自动生成命令时把 --testNamePattern 参数写崩了。
点边栏图标运行失败：空格和引号被错误注入
现象很典型：右键测试函数旁的绿色三角 → 点 Run，控制台输出里出现类似 ^ ?testing a test$ 这种带前导空格和孤立问号的字符串。Vitest 解析失败，要么跑全量、要么静默跳过。
- 根本原因是 WebStorm 2025.2+ 在拼接
--testNamePattern时，把测试名周围加了双引号，但又在等号后多塞了一个空格，变成--testNamePattern = "^..."，而 Vitest 只认--testNamePattern="^..." - 临时解法：不点边栏图标，改用右键测试文件 → Run “xxx.test.ts”，走文件级运行，完全绕过
--testNamePattern - 长期解法：进
Run | Edit Configurations→ 找到 Vitest 配置 → 在Vitest options栏手动填入--testNamePattern="^your test name$"，并勾选Use --testNamePattern from editor（如果该选项存在） - 验证是否修好：点开配置里的
Modify options→ 看最终命令行，确认--testNamePattern=后面是紧贴双引号的，中间没空格
Vitest 二进制路径填错：pnpm monorepo 下找不到模块
报错 Cannot find module 'vitest' 或直接无反应？别急着重装，八成是 WebStorm 没找对 vitest 的真实位置。
- pnpm workspace 下，
vitest很可能不在项目根node_modules/vitest，而在node_modules/.pnpm/vitest@4.0.7_xxx/node_modules/vitest或顶层node_modules/vitest - 别手输路径：在 Vitest 配置页点击
...按钮，用文件选择器逐层打开node_modules，精准定位到vitest.mjs（Vitest 4+ 主推 ESM 入口，比bin/vitest.js更稳） - 顺手检查
package.json：确认"type": "module"和"exports"字段还在，否则 WebStorm 可能解析不到正确入口
调试时断点不命中：“No tests found” 不是代码问题
你在测试函数里打了断点，Debug 启动后却提示 No tests found，控制台也看不到 defineComponent 或 mock 行为——这说明 WebStorm 没走 Vitest 的环境初始化流程。
- 普通 Debug 按钮启动的是 Node.js 模式，它跳过了
environment: "jsdom"、全局 mock、测试上下文注册等 Vitest 特有逻辑 - 必须用测试函数旁的专用图标：右键绿色三角 → 选 Debug “”（注意括号里是空的，不是普通 Debug）
- 确保
vitest.config.ts中environment值匹配你的目标：DOM 相关测试必须设为"jsdom"或"happy-dom"，纯工具函数可用"node"
最常被忽略的一点：Vitest 的 Browser Mode（真浏览器环境）在 4.0+ 已稳定，但 WebStorm 当前版本（2025.2）尚未原生支持该模式的调试入口——想用 Chromium/Playwright 跑测试，得切终端执行 vitest --browser，IDE 边栏和 Debug 图标暂时不接管。
