Angular项目中ng test未执行任何单元测试的原因排查

可能的原因及排查步骤 #

1. 核对spec文件的命名与存放位置 #

Angular CLI默认仅识别文件名以.spec.ts结尾的测试文件，且文件需放在CLI默认扫描的目录（如src/app子目录）内：

• 确认测试文件命名遵循[组件名].component.spec.ts这类规范
• 检查是否将spec文件放在了未被CLI配置覆盖的目录（如src/assets）

2. 验证angular.json的测试入口配置 #

重点核对test节点下的核心配置，确保测试入口文件正确：

"test": {
  "builder": "@angular-devkit/build-angular:karma",
  "options": {
    "main": "src/test.ts",
    "polyfills": "src/polyfills.ts",
    "tsConfig": "tsconfig.spec.json",
    "karmaConfig": "karma.conf.js"
  }
}

同时检查src/test.ts的内容，这个文件是测试套件的入口，必须包含正确的测试文件扫描逻辑：

import 'zone.js/testing';
import { getTestBed } from '@angular/core/testing';
import {
  BrowserDynamicTestingModule,
  platformBrowserDynamicTesting
} from '@angular/platform-browser-dynamic/testing';

declare const require: {
  context(path: string, deep?: boolean, filter?: RegExp): {
    keys(): string[];
    <T>(id: string): T;
  };
};

getTestBed().initTestEnvironment(
  BrowserDynamicTestingModule,
  platformBrowserDynamicTesting(),
);

// 扫描所有.spec.ts文件
const context = require.context('./', true, /\.spec\.ts$/);
context.keys().map(context);

如果这里的正则表达式被修改，会直接导致无法识别测试文件。

3. 检查tsconfig.spec.json的规则配置 #

确认配置中没有错误排除测试文件：

{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "outDir": "./out-tsc/spec",
    "types": ["jasmine"]
  },
  "files": ["src/test.ts", "src/polyfills.ts"],
  "include": ["src/**/*.spec.ts", "src/**/*.d.ts"]
}

• 确保include数组包含src/**/*.spec.ts，保证TypeScript编译时处理测试文件
• 若存在exclude数组，确认未包含测试文件或其所在目录

4. 补充Karma的明确文件加载规则 #

在你的karma.conf.js中添加强制加载测试入口的配置，避免自动扫描遗漏：

module.exports = function (config) {
  config.set({
    // 已有配置...
    files: [
      { pattern: './src/test.ts', watched: false }
    ],
    preprocessors: {
      './src/test.ts': ['@angular-devkit/build-angular']
    },
    // 已有配置...
  });
};

5. 清理缓存后重新测试 #

缓存可能导致测试文件无法被识别，执行以下命令清理后重试：

rm -rf node_modules .angular/cache
npm install
ng test --no-cache

6. 检查测试文件的语法错误 #

若某个spec文件存在语法错误，可能导致整个测试套件静默跳过。可以单独编译测试代码排查：

ng build --configuration test

修复编译错误后再运行ng test。

内容的提问来源于stack exchange，提问作者Karthik Nagaraj