Angular16升级后在IntelliJ运行单个Jest单元测试的配置问题

问题背景 #

升级Angular 15到16后，切换到Angular内置的实验性Jest支持，修改了angular.json的测试构建器为@angular-devkit/build-angular:jest，并把package.json的test脚本改为ng test。批量运行测试正常，但IntelliJ中单个测试运行报错；调整构建器为:run并修改Jest包路径后，又出现Unknown arguments: colors, reporters, verbose错误。

解决步骤 #

1. 恢复angular.json的测试构建器配置 #

将测试构建器改回不带:run后缀的版本，:run是CLI内部调用目标，不适合IDE直接对接：

"projects": {
  "your-project-name": {
    "architect": {
      "test": {
        "builder": "@angular-devkit/build-angular:jest",
        "options": {
          "tsConfig": "tsconfig.spec.json",
          "polyfills": ["src/polyfills.ts"]
        }
      }
    }
  }
}

2. 配置IntelliJ的Jest运行模板 #

• 打开Run/Debug Configurations → 编辑Jest模板（或新建Jest配置）
• Jest package选择项目根目录下的node_modules/@angular/cli
• Arguments清空默认参数（如--colors --reporters=default --verbose），无需额外传递，让Angular CLI处理参数逻辑
• Working directory设置为项目根目录

3. 调整IDE的Jest全局设置 #

• 打开Settings > Languages & Frameworks > JavaScript > Jest
• 勾选Manual configuration，Jest package选择@angular/cli，Configuration file留空（Angular通过angular.json管理配置）
• 取消勾选Run using jest.runner，强制IDE通过Angular CLI启动测试

4. 验证单测运行 #

右键点击测试文件中的单个用例或套件，选择Run 'XXX'，此时IDE会通过ng test的封装逻辑执行测试，避免原生Jest的参数冲突。

补充说明 #

如果使用IntelliJ 2023.1.x版本仍有问题，建议升级到2023.2及以上版本，新版本对Angular 16的实验性Jest支持做了适配，能更好地识别CLI封装的Jest执行逻辑。

内容的提问来源于stack exchange，提问作者Kevin Cruijssen