WebStorm中Vue项目Vitest无法运行，主因是Node≥20.0.0版本、vitest.config.ts路径及vitest.mjs入口三者未对齐；需手动指定解释器路径、配置文件位置和二进制入口，并用专用Debug图标调试。
WebStorm 里 Vue 项目跑不起来 Vitest，基本不是代码写错了，而是 Node 版本、配置文件加载路径、二进制入口这三处没对齐——尤其在 pnpm monorepo 或 WebStorm 2025.2+ 下，稍有偏差就卡在“测试图标不出现”或“No tests found”。
确认 Node 解释器路径和版本严格一致
WebStorm 显示的 Node 版本和实际运行时用的版本经常不一致。终端里 node -v 是 v20.12.0，但 WebStorm Settings → Languages & Frameworks → JavaScript → Node.js 里选的可能是系统默认的 v18.x，导致 ERR_UNSUPPORTED_ESM_URL_SCHEME。
- 别信 “Project” 别名，手动点开文件选择器，精准指向
/path/to/node-v20.12.0/bin/node（macOS/Linux）或C:\Program Files\nodejs\node.exe（Windows） - 如果用
nvm或nvm-windows，确保当前 shell 的node -v和 WebStorm 里选的一致，且重启 WebStorm - 检查
package.json是否含"type": "module"—— Vitest 4+ 依赖此字段解析vitest.mjs入口，删了会导致 WebStorm 找不到模块
手动指定 vitest.config.ts 并验证是否生效
WebStorm 不会像命令行那样向上查找配置文件。放错位置、命名不标准、或没在运行配置里填上路径，等于没配——vi.mock 失效、environment: "happy-dom" 不起作用、测试文件不出现在边栏，全因配置没加载。
- 必须用
vitest.config.ts或vitest.config.js；vitest.conf.mjs、tests/vitest.config.ts都不被自动识别 - 创建 Vitest 运行配置（Run → Edit Configurations → Vitest）时，务必填上
Config file字段，指向根目录下的真实路径 - 若用
vitest.config.ts，需确保已安装ts-node，或 WebStorm 的 TypeScript 服务已启用（Settings → Languages & Frameworks → TypeScript）
pnpm monorepo 下精准定位 vitest.mjs 入口
在 pnpm workspace 中，vitest 很可能不在 node_modules/vitest，而在 node_modules/.pnpm/vitest@4.0.7_... 子目录下。WebStorm 手输路径或依赖自动发现，大概率找不到，直接报 Cannot find module 'vitest'。
立即学习“前端免费学习笔记（深入）”；
- 不要手敲路径：在 Vitest 运行配置页点击右侧文件选择按钮，逐层打开
node_modules，找到真实的vitest.mjs（Vitest 4+ 推荐 ESM 入口，比bin/vitest.js更稳） - 检查
package.json的"exports"字段是否完整 —— 缺失会导致 WebStorm 解析不到正确入口 - 如果项目用了
"type": "module"，但exports被误删，vitest.mjs就不会被识别
边栏运行失败？绕过 --testNamePattern 格式 bug
WebStorm 2025.2+ 与 Vitest 4.07+ 配合时，点边栏绿色三角运行测试，IDE 会错误注入带空格的 --testNamePattern 参数，比如 --testNamePattern = "^test name$"，而 Vitest 只认 --testNamePattern="^test name$"。结果要么跑全量，要么静默跳过。
- 临时解法：右键测试文件 → Run “
filename.test.ts”，走文件级运行，完全绕过--testNamePattern - 长期解法：进 Run | Edit Configurations → Vitest 配置 → 在
Vitest options栏手动填入--testNamePattern="^your test name$"，并勾选Use --testNamePattern from editor（如果存在） - 验证是否修好：点开配置里的
Modify options→ 查看最终命令行，确认--testNamePattern=后面是紧贴双引号的，中间没空格
最常被忽略的是：调试时必须用测试函数旁的专用 Debug 图标（右键绿色三角 → Debug “test name”），而不是普通 Debug 按钮——后者走的是纯 Node.js 模式，跳过了 environment 初始化、全局 mock 注册和测试上下文，断点根本不会命中。
