PAYATHON 2026

WebStorm 2026 如何为 Angular 21 多项目工作区配置 Vitest?

数据阿明

应该怎样配置?

如果 Angular CLI 工作区已经能通过 ng test project1 运行测试,可以在 WebStorm 的 Vitest 运行配置中选择 @angular/cli,将工作目录设为工作区根目录,在 Vitest options 中填写 project1,并先选择 All tests。使用这种方式运行测试,无需新建 vitest.config.ts。

前提是 WebStorm 能识别 Angular CLI 的 Vitest 集成。JetBrains 的问题记录显示,这种配置实际调用 @angular/cli/bin/ng.js test,并附加 IDE 的测试报告参数。JetBrains Angular Vitest 集成记录

在 WebStorm 中填写运行配置

打开 Run | Edit Configurations,新增一个 Vitest 配置。以下路径以依赖安装在工作区根目录的常见布局为例:

配置项 建议值
Node.js runtime 与终端运行测试时使用的 Node.js 一致
Vitest package <workspace>/node_modules/@angular/cli
Working directory <workspace>,即包含 angular.json 的工作区根目录
Vitest options project1
测试范围 All tests
Configuration file 保持未指定,不额外创建配置文件

<workspace> 是实际工作区路径的占位符。如果依赖采用其他布局,请选择实际安装的 @angular/cli 包目录。

保存后点击 Run。project1 必须与 angular.json 中 projects 下的项目名称一致,它不一定与项目文件夹名称相同。Angular CLI 使用该名称选择测试目标。Angular CLI 的 ng test 参数说明

为什么选择 @angular/cli?

Angular CLI 会根据 angular.json 中的测试目标组织构建并启动测试 runner。通过 CLI 运行时,可以继续使用项目已有的 Angular 测试配置。Angular 测试配置说明

这里创建的是 WebStorm 的 Vitest 配置,启动入口仍然是 Angular CLI。IDE 会接收并展示测试结果,也无需建立 npm 运行配置。

如果将包路径改为 node_modules/vitest,则会直接启动 Vitest。此时不能假定它会自动执行 Angular CLI 的构建及测试初始化流程;单独添加一个空的 vitest.config.ts 也不能补齐这些步骤。

All tests 和 Directory 怎么选?

先选择 All tests,用 Vitest options 中的 project1 确定 Angular 项目,确认整个项目能否从 IDE 正常运行。

需要限制到某个测试目录时,再使用 Directory。目录筛选和 Angular 项目选择是两回事:选择文件夹并不等于指定 angular.json 中的项目。WebStorm 支持按测试、文件或目录选择运行范围。WebStorm Vitest 运行配置说明

配置后仍然找不到测试怎么办?

先在相同工作目录下运行:

ng test project1

然后检查 WebStorm 控制台的启动命令,确认入口指向工作区内的 @angular/cli/bin/ng.js,且测试命令包含 project1。IDE 可能会附加 reporter、筛选等参数,因此命令不必与终端完全相同。

如果 All tests 能运行,而 Directory 或单文件运行提示 No tests found matching the following patterns,应检查 IDE 生成的 --include 路径。JetBrains 记录过 2026.2 中错误地为该路径添加前导 / 的问题,WebStorm 2026.2.1 发布说明列出了对应修复 WEB-78871。只有错误现象与该问题一致时,才应据此判断为版本问题。问题记录、WebStorm 2026.2.1 发布说明

备注:内容仅供参考。