WebStorm 2025.2+ 与 Vitest 4.07+ 存在三大典型问题：一是边栏运行测试时 --testNamePattern 参数被错误注入空格和引号导致匹配失败；二是 vitest 二进制路径在 pnpm monorepo 下定位不准引发模块找不到；三是调试时未启用 Vitest 专用模式导致环境缺失、断点不命中或 defineComponent 未定义。

点击边栏图标运行测试失败，命令里多出空格和引号

这是 WebStorm 2025.2+ 版本与 Vitest 4.07+ 配合时的典型 bug：IDE 自动生成的命令把 --testNamePattern 的值错误拆成了带空格的字符串，比如 ^ ?testing a test$（注意问号前的空格），而终端下正确写法是 --testNamePattern="^testing a test$"。Vitest 解析失败，直接跳过匹配、跑全量测试或报错。

• 临时绕过：右键测试文件 → Run “filename.test.ts”（不点边栏图标），这样会走文件级运行，不拼 --testNamePattern
• 根本修复：进 Run | Edit Configurations → 找到 Vitest 配置 → 在 Vitest options 栏手动补上 --testNamePattern="^your test name$"，并勾选 Use --testNamePattern from editor（如果选项存在）
• 验证是否生效：点开运行配置的 Modify options → 查看最终生成命令，确认 --testNamePattern 后面是紧贴双引号的，没有空格插入

Vitest 运行配置里 vitest 包路径填错导致找不到二进制

WebStorm 默认尝试从项目根找 node_modules/vitest，但如果你用 pnpm + workspace 或 monorepo，实际 vitest 可能在 node_modules/.pnpm/vitest@x.x.x/node_modules/vitest 下，或者被提升到了顶层 node_modules。填错路径会导致“Cannot find module 'vitest'”或直接静默失败。

• 别手输路径：在 Vitest 配置页点击 ... 按钮，从弹出的文件选择器里逐层打开 node_modules，精准定位到 vitest.mjs 或 bin/vitest.js
• 优先选 vitest.mjs：Vitest 4+ 主推 ESM 入口，用 vitest.mjs 比 bin/vitest.js 更少触发 --experimental-vm-modules 报错
• 检查 package.json：确认 "type": "module" 和 "exports" 字段没被误删 —— 这会影响 WebStorm 解析包入口

调试时断点不命中，控制台显示 “No tests found”

不是代码问题，而是 WebStorm 调试模式默认不加载 test 环境配置，它按 Node.js 常规方式启动，跳过了 Vitest 的环境初始化逻辑，比如 environment: "jsdom" 或 mock 行为失效，导致测试函数压根没注册。

• 必须启用 Vitest 专用调试：在测试函数旁边栏图标上右键 → 选 Debug “test name”，不能点普通 Debug 按钮
• 确保 vitest.config.ts 中的 environment 与你调试目标一致：组件测试要 "jsdom"，纯工具函数就用 "node"；混用会直接中断调试流程
• 检查 Node.js 版本兼容性：Vitest 4.07 要求 Node ≥ v20.0.0，但 WebStorm 若调用了系统全局 Node（如 v18），也会让调试器卡在加载阶段 —— 在配置里显式指定 Node interpreter 为 nvm 管理的 v20+

组件测试（Vue/React）跑不起来，报错说 defineComponent is not defined

这不是 Vitest 本身的问题，而是 WebStorm 没识别出你正在测组件，仍以纯 Node 环境执行，缺少框架运行时上下文。尤其在 Vue 项目中，defineComponent 是 @vue/runtime-core 提供的，Node 下根本不存在。

• 必须配 environment: "jsdom"：在 vitest.config.ts 的 test 选项里明确写死，不能只靠插件自动推断
• 装对测试工具链：Vue 项目必须有 @vue/test-utils，React 项目得有 @testing-library/react；缺一个，render 函数就不可用，调试器连 setup 阶段都进不去
• 别信“自动检测”：WebStorm 的 Vitest 集成不会读取 vite.config.ts 里的 plugins，所以即使你已加了 vite-plugin-vue，也得手动在 Vitest 配置里重复声明 environmentOptions 或 setupFiles

最常被忽略的是环境隔离 —— 同一个项目里，工具函数测试和组件测试可能需要两套 Vitest 配置，WebStorm 不支持单配置切换环境，得手动建两个运行配置，分别指向不同 --config 文件。