使用Jest测试TypeScript接口：代码覆盖率问题咨询

数据老陈

2026-5-19

嘿，这个问题我之前在项目里也遇到过，给你详细拆解一下：

TypeScript接口是否可被统计代码覆盖率？

答案是本质上不需要也无法被统计——因为TypeScript的接口是纯编译时的类型定义，在编译成JavaScript后会被完全移除，不会生成任何可执行的运行时代码。

那为什么你的覆盖率报告里会显示接口所在的行未被覆盖？这是因为Jest（配合ts-jest这类转换器）会把TypeScript源码和编译后的JavaScript做映射，接口定义的行在TS里存在，但对应的JS里没有任何代码，覆盖率工具就会把这些行标记为“未覆盖”，但这其实是个“假阳性”的提示——根本没有可执行代码需要测试覆盖。

是否应将接口排除在覆盖率报告外？

必须要排除！原因很简单：

接口是类型约束，不属于业务逻辑或可执行代码，测试它们没有实际意义；
不排除的话，会拉低整体覆盖率百分比，让你误以为有未测试的运行逻辑，干扰对测试完整性的判断。

怎么排除接口的覆盖率统计？

有几种常用方式：

全局配置排除文件
在你的Jest配置文件（比如jest.config.js）里，通过collectCoverageFrom字段过滤掉接口相关文件：

module.exports = {
  // 其他配置...
  collectCoverageFrom: [
    "src/**/*.{ts,tsx}", // 包含所有TS/TSX文件
    "!src/**/*.d.ts", // 排除单独的类型声明文件
    "!src/**/interfaces/**", // 排除存放接口的单独目录
    "!src/**/*interface.ts" // 排除命名带interface的文件
  ]
};

单文件/单行忽略
如果接口和业务代码混在同一个文件里，可以用Istanbul的注释指令忽略：
- 忽略整个文件：在文件最顶部加/* istanbul ignore file */；
- 忽略单行接口：在接口定义前加/* istanbul ignore next */：
```
/* istanbul ignore next */
interface UserInfo {
  userId: string;
  userName: string;
}
```